Imported Upstream version 3.3.1
[platform/upstream/ccache.git] / NEWS.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"\r
2     "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">\r
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">\r
4 <head>\r
5 <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />\r
6 <meta name="generator" content="AsciiDoc 8.6.9" />\r
7 <title>ccache news</title>\r
8 <style type="text/css">\r
9 /* Shared CSS for AsciiDoc xhtml11 and html5 backends */\r
10 \r
11 /* Default font. */\r
12 body {\r
13   font-family: Georgia,serif;\r
14 }\r
15 \r
16 /* Title font. */\r
17 h1, h2, h3, h4, h5, h6,\r
18 div.title, caption.title,\r
19 thead, p.table.header,\r
20 #toctitle,\r
21 #author, #revnumber, #revdate, #revremark,\r
22 #footer {\r
23   font-family: Arial,Helvetica,sans-serif;\r
24 }\r
25 \r
26 body {\r
27   margin: 1em 5% 1em 5%;\r
28 }\r
29 \r
30 a {\r
31   color: blue;\r
32   text-decoration: underline;\r
33 }\r
34 a:visited {\r
35   color: fuchsia;\r
36 }\r
37 \r
38 em {\r
39   font-style: italic;\r
40   color: navy;\r
41 }\r
42 \r
43 strong {\r
44   font-weight: bold;\r
45   color: #083194;\r
46 }\r
47 \r
48 h1, h2, h3, h4, h5, h6 {\r
49   color: #527bbd;\r
50   margin-top: 1.2em;\r
51   margin-bottom: 0.5em;\r
52   line-height: 1.3;\r
53 }\r
54 \r
55 h1, h2, h3 {\r
56   border-bottom: 2px solid silver;\r
57 }\r
58 h2 {\r
59   padding-top: 0.5em;\r
60 }\r
61 h3 {\r
62   float: left;\r
63 }\r
64 h3 + * {\r
65   clear: left;\r
66 }\r
67 h5 {\r
68   font-size: 1.0em;\r
69 }\r
70 \r
71 div.sectionbody {\r
72   margin-left: 0;\r
73 }\r
74 \r
75 hr {\r
76   border: 1px solid silver;\r
77 }\r
78 \r
79 p {\r
80   margin-top: 0.5em;\r
81   margin-bottom: 0.5em;\r
82 }\r
83 \r
84 ul, ol, li > p {\r
85   margin-top: 0;\r
86 }\r
87 ul > li     { color: #aaa; }\r
88 ul > li > * { color: black; }\r
89 \r
90 .monospaced, code, pre {\r
91   font-family: "Courier New", Courier, monospace;\r
92   font-size: inherit;\r
93   color: navy;\r
94   padding: 0;\r
95   margin: 0;\r
96 }\r
97 pre {\r
98   white-space: pre-wrap;\r
99 }\r
100 \r
101 #author {\r
102   color: #527bbd;\r
103   font-weight: bold;\r
104   font-size: 1.1em;\r
105 }\r
106 #email {\r
107 }\r
108 #revnumber, #revdate, #revremark {\r
109 }\r
110 \r
111 #footer {\r
112   font-size: small;\r
113   border-top: 2px solid silver;\r
114   padding-top: 0.5em;\r
115   margin-top: 4.0em;\r
116 }\r
117 #footer-text {\r
118   float: left;\r
119   padding-bottom: 0.5em;\r
120 }\r
121 #footer-badges {\r
122   float: right;\r
123   padding-bottom: 0.5em;\r
124 }\r
125 \r
126 #preamble {\r
127   margin-top: 1.5em;\r
128   margin-bottom: 1.5em;\r
129 }\r
130 div.imageblock, div.exampleblock, div.verseblock,\r
131 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,\r
132 div.admonitionblock {\r
133   margin-top: 1.0em;\r
134   margin-bottom: 1.5em;\r
135 }\r
136 div.admonitionblock {\r
137   margin-top: 2.0em;\r
138   margin-bottom: 2.0em;\r
139   margin-right: 10%;\r
140   color: #606060;\r
141 }\r
142 \r
143 div.content { /* Block element content. */\r
144   padding: 0;\r
145 }\r
146 \r
147 /* Block element titles. */\r
148 div.title, caption.title {\r
149   color: #527bbd;\r
150   font-weight: bold;\r
151   text-align: left;\r
152   margin-top: 1.0em;\r
153   margin-bottom: 0.5em;\r
154 }\r
155 div.title + * {\r
156   margin-top: 0;\r
157 }\r
158 \r
159 td div.title:first-child {\r
160   margin-top: 0.0em;\r
161 }\r
162 div.content div.title:first-child {\r
163   margin-top: 0.0em;\r
164 }\r
165 div.content + div.title {\r
166   margin-top: 0.0em;\r
167 }\r
168 \r
169 div.sidebarblock > div.content {\r
170   background: #ffffee;\r
171   border: 1px solid #dddddd;\r
172   border-left: 4px solid #f0f0f0;\r
173   padding: 0.5em;\r
174 }\r
175 \r
176 div.listingblock > div.content {\r
177   border: 1px solid #dddddd;\r
178   border-left: 5px solid #f0f0f0;\r
179   background: #f8f8f8;\r
180   padding: 0.5em;\r
181 }\r
182 \r
183 div.quoteblock, div.verseblock {\r
184   padding-left: 1.0em;\r
185   margin-left: 1.0em;\r
186   margin-right: 10%;\r
187   border-left: 5px solid #f0f0f0;\r
188   color: #888;\r
189 }\r
190 \r
191 div.quoteblock > div.attribution {\r
192   padding-top: 0.5em;\r
193   text-align: right;\r
194 }\r
195 \r
196 div.verseblock > pre.content {\r
197   font-family: inherit;\r
198   font-size: inherit;\r
199 }\r
200 div.verseblock > div.attribution {\r
201   padding-top: 0.75em;\r
202   text-align: left;\r
203 }\r
204 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */\r
205 div.verseblock + div.attribution {\r
206   text-align: left;\r
207 }\r
208 \r
209 div.admonitionblock .icon {\r
210   vertical-align: top;\r
211   font-size: 1.1em;\r
212   font-weight: bold;\r
213   text-decoration: underline;\r
214   color: #527bbd;\r
215   padding-right: 0.5em;\r
216 }\r
217 div.admonitionblock td.content {\r
218   padding-left: 0.5em;\r
219   border-left: 3px solid #dddddd;\r
220 }\r
221 \r
222 div.exampleblock > div.content {\r
223   border-left: 3px solid #dddddd;\r
224   padding-left: 0.5em;\r
225 }\r
226 \r
227 div.imageblock div.content { padding-left: 0; }\r
228 span.image img { border-style: none; vertical-align: text-bottom; }\r
229 a.image:visited { color: white; }\r
230 \r
231 dl {\r
232   margin-top: 0.8em;\r
233   margin-bottom: 0.8em;\r
234 }\r
235 dt {\r
236   margin-top: 0.5em;\r
237   margin-bottom: 0;\r
238   font-style: normal;\r
239   color: navy;\r
240 }\r
241 dd > *:first-child {\r
242   margin-top: 0.1em;\r
243 }\r
244 \r
245 ul, ol {\r
246     list-style-position: outside;\r
247 }\r
248 ol.arabic {\r
249   list-style-type: decimal;\r
250 }\r
251 ol.loweralpha {\r
252   list-style-type: lower-alpha;\r
253 }\r
254 ol.upperalpha {\r
255   list-style-type: upper-alpha;\r
256 }\r
257 ol.lowerroman {\r
258   list-style-type: lower-roman;\r
259 }\r
260 ol.upperroman {\r
261   list-style-type: upper-roman;\r
262 }\r
263 \r
264 div.compact ul, div.compact ol,\r
265 div.compact p, div.compact p,\r
266 div.compact div, div.compact div {\r
267   margin-top: 0.1em;\r
268   margin-bottom: 0.1em;\r
269 }\r
270 \r
271 tfoot {\r
272   font-weight: bold;\r
273 }\r
274 td > div.verse {\r
275   white-space: pre;\r
276 }\r
277 \r
278 div.hdlist {\r
279   margin-top: 0.8em;\r
280   margin-bottom: 0.8em;\r
281 }\r
282 div.hdlist tr {\r
283   padding-bottom: 15px;\r
284 }\r
285 dt.hdlist1.strong, td.hdlist1.strong {\r
286   font-weight: bold;\r
287 }\r
288 td.hdlist1 {\r
289   vertical-align: top;\r
290   font-style: normal;\r
291   padding-right: 0.8em;\r
292   color: navy;\r
293 }\r
294 td.hdlist2 {\r
295   vertical-align: top;\r
296 }\r
297 div.hdlist.compact tr {\r
298   margin: 0;\r
299   padding-bottom: 0;\r
300 }\r
301 \r
302 .comment {\r
303   background: yellow;\r
304 }\r
305 \r
306 .footnote, .footnoteref {\r
307   font-size: 0.8em;\r
308 }\r
309 \r
310 span.footnote, span.footnoteref {\r
311   vertical-align: super;\r
312 }\r
313 \r
314 #footnotes {\r
315   margin: 20px 0 20px 0;\r
316   padding: 7px 0 0 0;\r
317 }\r
318 \r
319 #footnotes div.footnote {\r
320   margin: 0 0 5px 0;\r
321 }\r
322 \r
323 #footnotes hr {\r
324   border: none;\r
325   border-top: 1px solid silver;\r
326   height: 1px;\r
327   text-align: left;\r
328   margin-left: 0;\r
329   width: 20%;\r
330   min-width: 100px;\r
331 }\r
332 \r
333 div.colist td {\r
334   padding-right: 0.5em;\r
335   padding-bottom: 0.3em;\r
336   vertical-align: top;\r
337 }\r
338 div.colist td img {\r
339   margin-top: 0.3em;\r
340 }\r
341 \r
342 @media print {\r
343   #footer-badges { display: none; }\r
344 }\r
345 \r
346 #toc {\r
347   margin-bottom: 2.5em;\r
348 }\r
349 \r
350 #toctitle {\r
351   color: #527bbd;\r
352   font-size: 1.1em;\r
353   font-weight: bold;\r
354   margin-top: 1.0em;\r
355   margin-bottom: 0.1em;\r
356 }\r
357 \r
358 div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {\r
359   margin-top: 0;\r
360   margin-bottom: 0;\r
361 }\r
362 div.toclevel2 {\r
363   margin-left: 2em;\r
364   font-size: 0.9em;\r
365 }\r
366 div.toclevel3 {\r
367   margin-left: 4em;\r
368   font-size: 0.9em;\r
369 }\r
370 div.toclevel4 {\r
371   margin-left: 6em;\r
372   font-size: 0.9em;\r
373 }\r
374 \r
375 span.aqua { color: aqua; }\r
376 span.black { color: black; }\r
377 span.blue { color: blue; }\r
378 span.fuchsia { color: fuchsia; }\r
379 span.gray { color: gray; }\r
380 span.green { color: green; }\r
381 span.lime { color: lime; }\r
382 span.maroon { color: maroon; }\r
383 span.navy { color: navy; }\r
384 span.olive { color: olive; }\r
385 span.purple { color: purple; }\r
386 span.red { color: red; }\r
387 span.silver { color: silver; }\r
388 span.teal { color: teal; }\r
389 span.white { color: white; }\r
390 span.yellow { color: yellow; }\r
391 \r
392 span.aqua-background { background: aqua; }\r
393 span.black-background { background: black; }\r
394 span.blue-background { background: blue; }\r
395 span.fuchsia-background { background: fuchsia; }\r
396 span.gray-background { background: gray; }\r
397 span.green-background { background: green; }\r
398 span.lime-background { background: lime; }\r
399 span.maroon-background { background: maroon; }\r
400 span.navy-background { background: navy; }\r
401 span.olive-background { background: olive; }\r
402 span.purple-background { background: purple; }\r
403 span.red-background { background: red; }\r
404 span.silver-background { background: silver; }\r
405 span.teal-background { background: teal; }\r
406 span.white-background { background: white; }\r
407 span.yellow-background { background: yellow; }\r
408 \r
409 span.big { font-size: 2em; }\r
410 span.small { font-size: 0.6em; }\r
411 \r
412 span.underline { text-decoration: underline; }\r
413 span.overline { text-decoration: overline; }\r
414 span.line-through { text-decoration: line-through; }\r
415 \r
416 div.unbreakable { page-break-inside: avoid; }\r
417 \r
418 \r
419 /*\r
420  * xhtml11 specific\r
421  *\r
422  * */\r
423 \r
424 div.tableblock {\r
425   margin-top: 1.0em;\r
426   margin-bottom: 1.5em;\r
427 }\r
428 div.tableblock > table {\r
429   border: 3px solid #527bbd;\r
430 }\r
431 thead, p.table.header {\r
432   font-weight: bold;\r
433   color: #527bbd;\r
434 }\r
435 p.table {\r
436   margin-top: 0;\r
437 }\r
438 /* Because the table frame attribute is overriden by CSS in most browsers. */\r
439 div.tableblock > table[frame="void"] {\r
440   border-style: none;\r
441 }\r
442 div.tableblock > table[frame="hsides"] {\r
443   border-left-style: none;\r
444   border-right-style: none;\r
445 }\r
446 div.tableblock > table[frame="vsides"] {\r
447   border-top-style: none;\r
448   border-bottom-style: none;\r
449 }\r
450 \r
451 \r
452 /*\r
453  * html5 specific\r
454  *\r
455  * */\r
456 \r
457 table.tableblock {\r
458   margin-top: 1.0em;\r
459   margin-bottom: 1.5em;\r
460 }\r
461 thead, p.tableblock.header {\r
462   font-weight: bold;\r
463   color: #527bbd;\r
464 }\r
465 p.tableblock {\r
466   margin-top: 0;\r
467 }\r
468 table.tableblock {\r
469   border-width: 3px;\r
470   border-spacing: 0px;\r
471   border-style: solid;\r
472   border-color: #527bbd;\r
473   border-collapse: collapse;\r
474 }\r
475 th.tableblock, td.tableblock {\r
476   border-width: 1px;\r
477   padding: 4px;\r
478   border-style: solid;\r
479   border-color: #527bbd;\r
480 }\r
481 \r
482 table.tableblock.frame-topbot {\r
483   border-left-style: hidden;\r
484   border-right-style: hidden;\r
485 }\r
486 table.tableblock.frame-sides {\r
487   border-top-style: hidden;\r
488   border-bottom-style: hidden;\r
489 }\r
490 table.tableblock.frame-none {\r
491   border-style: hidden;\r
492 }\r
493 \r
494 th.tableblock.halign-left, td.tableblock.halign-left {\r
495   text-align: left;\r
496 }\r
497 th.tableblock.halign-center, td.tableblock.halign-center {\r
498   text-align: center;\r
499 }\r
500 th.tableblock.halign-right, td.tableblock.halign-right {\r
501   text-align: right;\r
502 }\r
503 \r
504 th.tableblock.valign-top, td.tableblock.valign-top {\r
505   vertical-align: top;\r
506 }\r
507 th.tableblock.valign-middle, td.tableblock.valign-middle {\r
508   vertical-align: middle;\r
509 }\r
510 th.tableblock.valign-bottom, td.tableblock.valign-bottom {\r
511   vertical-align: bottom;\r
512 }\r
513 \r
514 \r
515 /*\r
516  * manpage specific\r
517  *\r
518  * */\r
519 \r
520 body.manpage h1 {\r
521   padding-top: 0.5em;\r
522   padding-bottom: 0.5em;\r
523   border-top: 2px solid silver;\r
524   border-bottom: 2px solid silver;\r
525 }\r
526 body.manpage h2 {\r
527   border-style: none;\r
528 }\r
529 body.manpage div.sectionbody {\r
530   margin-left: 3em;\r
531 }\r
532 \r
533 @media print {\r
534   body.manpage div#toc { display: none; }\r
535 }\r
536 \r
537 \r
538 </style>\r
539 <script type="text/javascript">\r
540 /*<![CDATA[*/\r
541 var asciidoc = {  // Namespace.\r
542 \r
543 /////////////////////////////////////////////////////////////////////\r
544 // Table Of Contents generator\r
545 /////////////////////////////////////////////////////////////////////\r
546 \r
547 /* Author: Mihai Bazon, September 2002\r
548  * http://students.infoiasi.ro/~mishoo\r
549  *\r
550  * Table Of Content generator\r
551  * Version: 0.4\r
552  *\r
553  * Feel free to use this script under the terms of the GNU General Public\r
554  * License, as long as you do not remove or alter this notice.\r
555  */\r
556 \r
557  /* modified by Troy D. Hanson, September 2006. License: GPL */\r
558  /* modified by Stuart Rackham, 2006, 2009. License: GPL */\r
559 \r
560 // toclevels = 1..4.\r
561 toc: function (toclevels) {\r
562 \r
563   function getText(el) {\r
564     var text = "";\r
565     for (var i = el.firstChild; i != null; i = i.nextSibling) {\r
566       if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.\r
567         text += i.data;\r
568       else if (i.firstChild != null)\r
569         text += getText(i);\r
570     }\r
571     return text;\r
572   }\r
573 \r
574   function TocEntry(el, text, toclevel) {\r
575     this.element = el;\r
576     this.text = text;\r
577     this.toclevel = toclevel;\r
578   }\r
579 \r
580   function tocEntries(el, toclevels) {\r
581     var result = new Array;\r
582     var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');\r
583     // Function that scans the DOM tree for header elements (the DOM2\r
584     // nodeIterator API would be a better technique but not supported by all\r
585     // browsers).\r
586     var iterate = function (el) {\r
587       for (var i = el.firstChild; i != null; i = i.nextSibling) {\r
588         if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {\r
589           var mo = re.exec(i.tagName);\r
590           if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {\r
591             result[result.length] = new TocEntry(i, getText(i), mo[1]-1);\r
592           }\r
593           iterate(i);\r
594         }\r
595       }\r
596     }\r
597     iterate(el);\r
598     return result;\r
599   }\r
600 \r
601   var toc = document.getElementById("toc");\r
602   if (!toc) {\r
603     return;\r
604   }\r
605 \r
606   // Delete existing TOC entries in case we're reloading the TOC.\r
607   var tocEntriesToRemove = [];\r
608   var i;\r
609   for (i = 0; i < toc.childNodes.length; i++) {\r
610     var entry = toc.childNodes[i];\r
611     if (entry.nodeName.toLowerCase() == 'div'\r
612      && entry.getAttribute("class")\r
613      && entry.getAttribute("class").match(/^toclevel/))\r
614       tocEntriesToRemove.push(entry);\r
615   }\r
616   for (i = 0; i < tocEntriesToRemove.length; i++) {\r
617     toc.removeChild(tocEntriesToRemove[i]);\r
618   }\r
619 \r
620   // Rebuild TOC entries.\r
621   var entries = tocEntries(document.getElementById("content"), toclevels);\r
622   for (var i = 0; i < entries.length; ++i) {\r
623     var entry = entries[i];\r
624     if (entry.element.id == "")\r
625       entry.element.id = "_toc_" + i;\r
626     var a = document.createElement("a");\r
627     a.href = "#" + entry.element.id;\r
628     a.appendChild(document.createTextNode(entry.text));\r
629     var div = document.createElement("div");\r
630     div.appendChild(a);\r
631     div.className = "toclevel" + entry.toclevel;\r
632     toc.appendChild(div);\r
633   }\r
634   if (entries.length == 0)\r
635     toc.parentNode.removeChild(toc);\r
636 },\r
637 \r
638 \r
639 /////////////////////////////////////////////////////////////////////\r
640 // Footnotes generator\r
641 /////////////////////////////////////////////////////////////////////\r
642 \r
643 /* Based on footnote generation code from:\r
644  * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html\r
645  */\r
646 \r
647 footnotes: function () {\r
648   // Delete existing footnote entries in case we're reloading the footnodes.\r
649   var i;\r
650   var noteholder = document.getElementById("footnotes");\r
651   if (!noteholder) {\r
652     return;\r
653   }\r
654   var entriesToRemove = [];\r
655   for (i = 0; i < noteholder.childNodes.length; i++) {\r
656     var entry = noteholder.childNodes[i];\r
657     if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")\r
658       entriesToRemove.push(entry);\r
659   }\r
660   for (i = 0; i < entriesToRemove.length; i++) {\r
661     noteholder.removeChild(entriesToRemove[i]);\r
662   }\r
663 \r
664   // Rebuild footnote entries.\r
665   var cont = document.getElementById("content");\r
666   var spans = cont.getElementsByTagName("span");\r
667   var refs = {};\r
668   var n = 0;\r
669   for (i=0; i<spans.length; i++) {\r
670     if (spans[i].className == "footnote") {\r
671       n++;\r
672       var note = spans[i].getAttribute("data-note");\r
673       if (!note) {\r
674         // Use [\s\S] in place of . so multi-line matches work.\r
675         // Because JavaScript has no s (dotall) regex flag.\r
676         note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];\r
677         spans[i].innerHTML =\r
678           "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +\r
679           "' title='View footnote' class='footnote'>" + n + "</a>]";\r
680         spans[i].setAttribute("data-note", note);\r
681       }\r
682       noteholder.innerHTML +=\r
683         "<div class='footnote' id='_footnote_" + n + "'>" +\r
684         "<a href='#_footnoteref_" + n + "' title='Return to text'>" +\r
685         n + "</a>. " + note + "</div>";\r
686       var id =spans[i].getAttribute("id");\r
687       if (id != null) refs["#"+id] = n;\r
688     }\r
689   }\r
690   if (n == 0)\r
691     noteholder.parentNode.removeChild(noteholder);\r
692   else {\r
693     // Process footnoterefs.\r
694     for (i=0; i<spans.length; i++) {\r
695       if (spans[i].className == "footnoteref") {\r
696         var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");\r
697         href = href.match(/#.*/)[0];  // Because IE return full URL.\r
698         n = refs[href];\r
699         spans[i].innerHTML =\r
700           "[<a href='#_footnote_" + n +\r
701           "' title='View footnote' class='footnote'>" + n + "</a>]";\r
702       }\r
703     }\r
704   }\r
705 },\r
706 \r
707 install: function(toclevels) {\r
708   var timerId;\r
709 \r
710   function reinstall() {\r
711     asciidoc.footnotes();\r
712     if (toclevels) {\r
713       asciidoc.toc(toclevels);\r
714     }\r
715   }\r
716 \r
717   function reinstallAndRemoveTimer() {\r
718     clearInterval(timerId);\r
719     reinstall();\r
720   }\r
721 \r
722   timerId = setInterval(reinstall, 500);\r
723   if (document.addEventListener)\r
724     document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);\r
725   else\r
726     window.onload = reinstallAndRemoveTimer;\r
727 }\r
728 \r
729 }\r
730 asciidoc.install(2);\r
731 /*]]>*/\r
732 </script>\r
733 </head>\r
734 <body class="article">\r
735 <div id="header">\r
736 <h1>ccache news</h1>\r
737 <span id="revnumber">version 3.3.1</span>\r
738 <div id="toc">
739   <div id="toctitle">Table of Contents</div>
740   <noscript><p><b>JavaScript must be enabled in your browser to display the table of contents.</b></p></noscript>
741 </div>\r
742 </div>\r
743 <div id="content">\r
744 <div class="sect1">\r
745 <h2 id="_ccache_3_3_1">ccache 3.3.1</h2>\r
746 <div class="sectionbody">\r
747 <div class="paragraph"><p>Release date: 2016-09-07</p></div>\r
748 <div class="sect2">\r
749 <h3 id="_bug_fixes">Bug fixes</h3>\r
750 <div class="ulist"><ul>\r
751 <li>\r
752 <p>\r
753 Fixed a problem in the &#8220;multiple <code>-arch</code> options&#8221; support introduced in\r
754   3.3. When using the direct mode (the default), different combinations of\r
755   <code>-arch</code> options were not detected properly.\r
756 </p>\r
757 </li>\r
758 <li>\r
759 <p>\r
760 Fixed an issue when compiler option <code>-Wp,-MT,path</code> is used instead of <code>-MT\r
761   path</code> (and similar for <code>-MF</code>, <code>-MP</code> and <code>-MQ</code>) and <code>run_second_cpp</code>\r
762   (<code>CCACHE_CPP2</code>) is enabled.\r
763 </p>\r
764 </li>\r
765 </ul></div>\r
766 </div>\r
767 </div>\r
768 </div>\r
769 <div class="sect1">\r
770 <h2 id="_ccache_3_3">ccache 3.3</h2>\r
771 <div class="sectionbody">\r
772 <div class="paragraph"><p>Release date: 2016-08-27</p></div>\r
773 <div class="sect2">\r
774 <h3 id="_notes">Notes</h3>\r
775 <div class="ulist"><ul>\r
776 <li>\r
777 <p>\r
778 A C99-compatible compiler is now required to build ccache.\r
779 </p>\r
780 </li>\r
781 </ul></div>\r
782 </div>\r
783 <div class="sect2">\r
784 <h3 id="_new_features_and_improvements">New features and improvements</h3>\r
785 <div class="ulist"><ul>\r
786 <li>\r
787 <p>\r
788 The configuration option <code>run_second_cpp</code> (<code>CCACHE_CPP2</code>) now defaults to\r
789   true. This improves ccache&#8217;s out-of-the-box experience for compilers that\r
790   can&#8217;t compile their own preprocessed output with the same outcome as if they\r
791   compiled the real source code directly, e.g. newer versions of GCC and Clang.\r
792 </p>\r
793 </li>\r
794 <li>\r
795 <p>\r
796 The configuration option <code>hash_dir</code> (<code>CCACHE_HASHDIR</code>) now defaults to true.\r
797 </p>\r
798 </li>\r
799 <li>\r
800 <p>\r
801 Added a new <code>ignore_headers_in_manifest</code> configuration option, which\r
802   specifies headers that should be ignored in the direct mode.\r
803 </p>\r
804 </li>\r
805 <li>\r
806 <p>\r
807 Added a new <code>prefix_command_cpp</code> (<code>CCACHE_PREFIX_CPP</code>) configuration option,\r
808   which specifies one or several prefixes to add to the command line ccache\r
809   uses when invoking the preprocessor.\r
810 </p>\r
811 </li>\r
812 <li>\r
813 <p>\r
814 Added a new <code>limit_multiple</code> (<code>CCACHE_LIMIT_MULTIPLE</code>) configuration option,\r
815   which specifies how much of the cache to remove when cleaning.\r
816 </p>\r
817 </li>\r
818 <li>\r
819 <p>\r
820 Added a new <code>keep_comments_cpp</code> (<code>CCACHE_COMMENTS</code>) configuration option,\r
821   which tells ccache not to discard the comments before hashing preprocessor\r
822   output. This can be used to check documentation with <strong>-Wdocumentation</strong>.\r
823 </p>\r
824 </li>\r
825 <li>\r
826 <p>\r
827 Added a new sloppiness option <code>no_system_headers</code>, which tells ccache not to\r
828   include system headers in manifest files.\r
829 </p>\r
830 </li>\r
831 <li>\r
832 <p>\r
833 Added a new statistics counter that tracks the number of performed cleanups\r
834   due to the cache size being over the limit. The value is shown in the output\r
835   of &#8220;ccache -s&#8221;.\r
836 </p>\r
837 </li>\r
838 <li>\r
839 <p>\r
840 Added support for relocating debug info directory using <code>-fdebug-prefix-map</code>.\r
841   This allows for cache hits even when <code>hash_dir</code> is used in combination with\r
842   <code>base_dir</code>.\r
843 </p>\r
844 </li>\r
845 <li>\r
846 <p>\r
847 Added a new &#8220;cache hit rate&#8221; field to the output of &#8220;ccache -s&#8221;.\r
848 </p>\r
849 </li>\r
850 <li>\r
851 <p>\r
852 Added support for caching compilation of assembler code produced by e.g.\r
853   &#8220;gcc -S file.c&#8221;.\r
854 </p>\r
855 </li>\r
856 <li>\r
857 <p>\r
858 Added support for cuda including the -optf/--options-file option.\r
859 </p>\r
860 </li>\r
861 <li>\r
862 <p>\r
863 Added support for Fortran 77.\r
864 </p>\r
865 </li>\r
866 <li>\r
867 <p>\r
868 Added support for multiple <code>-arch</code> options to produce "fat binaries".\r
869 </p>\r
870 </li>\r
871 <li>\r
872 <p>\r
873 Multiple identical <code>-arch</code> arguments are now handled without bailing.\r
874 </p>\r
875 </li>\r
876 <li>\r
877 <p>\r
878 The concatenated form of some long compiler options is now recognized, for\r
879   example when using <code>-isystemPATH</code> instead of <code>-isystem PATH</code>.\r
880 </p>\r
881 </li>\r
882 <li>\r
883 <p>\r
884 If hard-linking is enabled and but fails (e.g. due to cross-device linking),\r
885   ccache now falls back to copying instead of running the compiler.\r
886 </p>\r
887 </li>\r
888 <li>\r
889 <p>\r
890 Made the <code>hash_dir</code> option only have effect when generating debug info.\r
891 </p>\r
892 </li>\r
893 <li>\r
894 <p>\r
895 ccache now knows how to convert absolute paths to relative paths inside\r
896   dependency files when using <code>base_dir</code>.\r
897 </p>\r
898 </li>\r
899 <li>\r
900 <p>\r
901 Improved parsing of <code>-g*</code> options.\r
902 </p>\r
903 </li>\r
904 <li>\r
905 <p>\r
906 Made ccache understand <code>-Wp,-D*</code> options.\r
907 </p>\r
908 </li>\r
909 <li>\r
910 <p>\r
911 ccache now understands the undocumented <code>-coverage</code> (only one dash) GCC\r
912   option.\r
913 </p>\r
914 </li>\r
915 <li>\r
916 <p>\r
917 Names of included files are no longer included in the hash of the compiler&#8217;s\r
918   preprocessed output. This leads to more potential cache hits when not using\r
919   the direct mode.\r
920 </p>\r
921 </li>\r
922 <li>\r
923 <p>\r
924 Increased buffer size used when reading file data. This improves performance\r
925   slightly.\r
926 </p>\r
927 </li>\r
928 </ul></div>\r
929 </div>\r
930 <div class="sect2">\r
931 <h3 id="_bug_fixes_2">Bug fixes</h3>\r
932 <div class="ulist"><ul>\r
933 <li>\r
934 <p>\r
935 Bail out on too hard compiler option <code>-P</code>.\r
936 </p>\r
937 </li>\r
938 <li>\r
939 <p>\r
940 Fixed clang test suite when running on Linux.\r
941 </p>\r
942 </li>\r
943 <li>\r
944 <p>\r
945 Fixed build and test for MinGW32 and Windows.\r
946 </p>\r
947 </li>\r
948 </ul></div>\r
949 </div>\r
950 </div>\r
951 </div>\r
952 <div class="sect1">\r
953 <h2 id="_ccache_3_2_8">ccache 3.2.8</h2>\r
954 <div class="sectionbody">\r
955 <div class="paragraph"><p>Release date: 2016-09-07</p></div>\r
956 <div class="sect2">\r
957 <h3 id="_bug_fixes_3">Bug fixes</h3>\r
958 <div class="ulist"><ul>\r
959 <li>\r
960 <p>\r
961 Fixed an issue when compiler option <code>-Wp,-MT,path</code> is used instead of <code>-MT\r
962   path</code> (and similar for <code>-MF</code>, <code>-MP</code> and <code>-MQ</code>) and <code>run_second_cpp</code>\r
963   (<code>CCACHE_CPP2</code>) is enabled.\r
964 </p>\r
965 </li>\r
966 <li>\r
967 <p>\r
968 ccache now understands the undocumented <code>-coverage</code> (only one dash) GCC\r
969   option.\r
970 </p>\r
971 </li>\r
972 </ul></div>\r
973 </div>\r
974 </div>\r
975 </div>\r
976 <div class="sect1">\r
977 <h2 id="_ccache_3_2_7">ccache 3.2.7</h2>\r
978 <div class="sectionbody">\r
979 <div class="paragraph"><p>Release date: 2016-07-20</p></div>\r
980 <div class="sect2">\r
981 <h3 id="_bug_fixes_4">Bug fixes</h3>\r
982 <div class="ulist"><ul>\r
983 <li>\r
984 <p>\r
985 Fixed a bug which could lead to false cache hits for compiler command lines\r
986   with a missing argument to an option that takes an argument.\r
987 </p>\r
988 </li>\r
989 <li>\r
990 <p>\r
991 ccache now knows how to work around a glitch in the output of GCC 6&#8217;s\r
992   preprocessor.\r
993 </p>\r
994 </li>\r
995 </ul></div>\r
996 </div>\r
997 </div>\r
998 </div>\r
999 <div class="sect1">\r
1000 <h2 id="_ccache_3_2_6">ccache 3.2.6</h2>\r
1001 <div class="sectionbody">\r
1002 <div class="paragraph"><p>Release date: 2016-07-12</p></div>\r
1003 <div class="sect2">\r
1004 <h3 id="_bug_fixes_5">Bug fixes</h3>\r
1005 <div class="ulist"><ul>\r
1006 <li>\r
1007 <p>\r
1008 Fixed build problem on QNX, which lacks &#8220;SA_RESTART&#8221;.\r
1009 </p>\r
1010 </li>\r
1011 <li>\r
1012 <p>\r
1013 Bail out on compiler option <code>-fstack-usage</code> since it creates a <code>.su</code> file\r
1014   which ccache currently doesn&#8217;t handle.\r
1015 </p>\r
1016 </li>\r
1017 <li>\r
1018 <p>\r
1019 Fixed a bug where (due to ccache rewriting paths) the compiler could choose\r
1020   incorrect include files if <code>CCACHE_BASEDIR</code> is used and the source file path\r
1021   is absolute and is a symlink.\r
1022 </p>\r
1023 </li>\r
1024 </ul></div>\r
1025 </div>\r
1026 </div>\r
1027 </div>\r
1028 <div class="sect1">\r
1029 <h2 id="_ccache_3_2_5">ccache 3.2.5</h2>\r
1030 <div class="sectionbody">\r
1031 <div class="paragraph"><p>Release date: 2016-04-17</p></div>\r
1032 <div class="sect2">\r
1033 <h3 id="_new_features_and_improvements_2">New features and improvements</h3>\r
1034 <div class="ulist"><ul>\r
1035 <li>\r
1036 <p>\r
1037 Only pass clang-specific <code>-stdlib=</code> to the preprocessor.\r
1038 </p>\r
1039 </li>\r
1040 <li>\r
1041 <p>\r
1042 Improved handling of stale NFS handles.\r
1043 </p>\r
1044 </li>\r
1045 <li>\r
1046 <p>\r
1047 Made it harder to misinterpret documentation of boolean environment settings'\r
1048   semantics.\r
1049 </p>\r
1050 </li>\r
1051 </ul></div>\r
1052 </div>\r
1053 <div class="sect2">\r
1054 <h3 id="_bug_fixes_6">Bug fixes</h3>\r
1055 <div class="ulist"><ul>\r
1056 <li>\r
1057 <p>\r
1058 Include m4 files used by configure.ac in the source dist archives.\r
1059 </p>\r
1060 </li>\r
1061 <li>\r
1062 <p>\r
1063 Corrected "Performance" section in the manual regarding <code>__DATE_</code>, <code>__TIME__</code>\r
1064   and <code>__FILE__</code> macros.\r
1065 </p>\r
1066 </li>\r
1067 <li>\r
1068 <p>\r
1069 Fixed build on Solaris 10+ and AIX 7.\r
1070 </p>\r
1071 </li>\r
1072 <li>\r
1073 <p>\r
1074 Fixed failure to create directories on QNX.\r
1075 </p>\r
1076 </li>\r
1077 <li>\r
1078 <p>\r
1079 Don&#8217;t (try to) update manifest file in &#8220;read-only&#8221; and &#8220;read-only direct&#8221;\r
1080   modes.\r
1081 </p>\r
1082 </li>\r
1083 <li>\r
1084 <p>\r
1085 Fixed a bug in caching of <code>stat</code> system calls in &#8220;file_stat_matches\r
1086   sloppiness mode&#8221;.\r
1087 </p>\r
1088 </li>\r
1089 <li>\r
1090 <p>\r
1091 Fixed bug in hashing of clang plugins, leading to unnecessary cache misses.\r
1092 </p>\r
1093 </li>\r
1094 <li>\r
1095 <p>\r
1096 Fixed --print-config to show &#8220;pch_defines sloppiness&#8221;.\r
1097 </p>\r
1098 </li>\r
1099 <li>\r
1100 <p>\r
1101 The man page is now built when running &#8220;make install&#8221; from Git repository\r
1102   sources.\r
1103 </p>\r
1104 </li>\r
1105 </ul></div>\r
1106 </div>\r
1107 </div>\r
1108 </div>\r
1109 <div class="sect1">\r
1110 <h2 id="_ccache_3_2_4">ccache 3.2.4</h2>\r
1111 <div class="sectionbody">\r
1112 <div class="paragraph"><p>Release date: 2015-10-08</p></div>\r
1113 <div class="sect2">\r
1114 <h3 id="_bug_fixes_7">Bug fixes</h3>\r
1115 <div class="ulist"><ul>\r
1116 <li>\r
1117 <p>\r
1118 Fixed build error related to zlib on systems with older make versions\r
1119   (regression in ccache 3.2.3).\r
1120 </p>\r
1121 </li>\r
1122 <li>\r
1123 <p>\r
1124 Made conversion-to-bool explicit to avoid build warnings (and potential\r
1125   runtime errors) on legacy systems.\r
1126 </p>\r
1127 </li>\r
1128 <li>\r
1129 <p>\r
1130 Improved signal handling: Kill compiler on SIGTERM; wait for compiler to exit\r
1131   before exiting; die appropriately.\r
1132 </p>\r
1133 </li>\r
1134 <li>\r
1135 <p>\r
1136 Minor fixes related to Windows support.\r
1137 </p>\r
1138 </li>\r
1139 <li>\r
1140 <p>\r
1141 The correct compression level is now used if compression is requested.\r
1142 </p>\r
1143 </li>\r
1144 <li>\r
1145 <p>\r
1146 Fixed a bug where cache cleanup could be run too early for caches larger than\r
1147   64 GiB on 32-bit systems.\r
1148 </p>\r
1149 </li>\r
1150 </ul></div>\r
1151 </div>\r
1152 </div>\r
1153 </div>\r
1154 <div class="sect1">\r
1155 <h2 id="_ccache_3_2_3">ccache 3.2.3</h2>\r
1156 <div class="sectionbody">\r
1157 <div class="paragraph"><p>Release date: 2015-08-16</p></div>\r
1158 <div class="sect2">\r
1159 <h3 id="_new_features_and_improvements_3">New features and improvements</h3>\r
1160 <div class="ulist"><ul>\r
1161 <li>\r
1162 <p>\r
1163 Added support for compiler option <code>-gsplit-dwarf</code>.\r
1164 </p>\r
1165 </li>\r
1166 </ul></div>\r
1167 </div>\r
1168 <div class="sect2">\r
1169 <h3 id="_bug_fixes_8">Bug fixes</h3>\r
1170 <div class="ulist"><ul>\r
1171 <li>\r
1172 <p>\r
1173 Support external zlib in nonstandard directory.\r
1174 </p>\r
1175 </li>\r
1176 <li>\r
1177 <p>\r
1178 Avoid calling <code>exit()</code> inside an exit handler.\r
1179 </p>\r
1180 </li>\r
1181 <li>\r
1182 <p>\r
1183 Let exit handler terminate properly.\r
1184 </p>\r
1185 </li>\r
1186 <li>\r
1187 <p>\r
1188 Bail out on compiler option <code>--save-temps</code> in addition to <code>-save-temps</code>.\r
1189 </p>\r
1190 </li>\r
1191 <li>\r
1192 <p>\r
1193 Only log "Disabling direct mode" once when failing to read potential include\r
1194   files.\r
1195 </p>\r
1196 </li>\r
1197 </ul></div>\r
1198 </div>\r
1199 </div>\r
1200 </div>\r
1201 <div class="sect1">\r
1202 <h2 id="_ccache_3_2_2">ccache 3.2.2</h2>\r
1203 <div class="sectionbody">\r
1204 <div class="paragraph"><p>Release date: 2015-05-10</p></div>\r
1205 <div class="sect2">\r
1206 <h3 id="_new_features_and_improvements_4">New features and improvements</h3>\r
1207 <div class="ulist"><ul>\r
1208 <li>\r
1209 <p>\r
1210 Added support for <code>CCACHE_COMPILERCHECK=string:&lt;value&gt;</code>. This is a faster\r
1211   alternative to <code>CCACHE_COMPILERCHECK=&lt;command&gt;</code> if the command&#8217;s output can\r
1212   be precalculated by the build system.\r
1213 </p>\r
1214 </li>\r
1215 <li>\r
1216 <p>\r
1217 Add support for caching code coverage results (compiling for gcov).\r
1218 </p>\r
1219 </li>\r
1220 </ul></div>\r
1221 </div>\r
1222 <div class="sect2">\r
1223 <h3 id="_bug_fixes_9">Bug fixes</h3>\r
1224 <div class="ulist"><ul>\r
1225 <li>\r
1226 <p>\r
1227 Made hash of cached result created with and without <code>CCACHE_CPP2</code> different.\r
1228   This makes it possible to rebuild with <code>CCACHE_CPP2</code> set without having to\r
1229   clear the cache to get new results.\r
1230 </p>\r
1231 </li>\r
1232 <li>\r
1233 <p>\r
1234 Don&#8217;t try to reset a non-existing stats file. This avoids &#8220;No such file or\r
1235   directory&#8221; messages in the ccache log when the cache directory doesn&#8217;t\r
1236   exist.\r
1237 </p>\r
1238 </li>\r
1239 <li>\r
1240 <p>\r
1241 Fixed a bug where ccache deleted clang diagnostics after compiler failures.\r
1242 </p>\r
1243 </li>\r
1244 <li>\r
1245 <p>\r
1246 Avoid performing an unnecessary copy of the object file on a cache miss.\r
1247 </p>\r
1248 </li>\r
1249 <li>\r
1250 <p>\r
1251 Bail out on too hard compiler option <code>-fmodules</code>.\r
1252 </p>\r
1253 </li>\r
1254 <li>\r
1255 <p>\r
1256 Bail out on too hard compiler option <code>-fplugin=libcc1plugin</code> (interaction\r
1257   with GDB).\r
1258 </p>\r
1259 </li>\r
1260 <li>\r
1261 <p>\r
1262 Fixed build error when compiling ccache with recent clang versions.\r
1263 </p>\r
1264 </li>\r
1265 <li>\r
1266 <p>\r
1267 Removed signal-unsafe code from signal handler.\r
1268 </p>\r
1269 </li>\r
1270 <li>\r
1271 <p>\r
1272 Corrected logic for when to output cached stderr.\r
1273 </p>\r
1274 </li>\r
1275 <li>\r
1276 <p>\r
1277 Wipe the whole cached result on failure retrieving a cached file.\r
1278 </p>\r
1279 </li>\r
1280 <li>\r
1281 <p>\r
1282 Fixed build error when compiling ccache with recent clang versions.\r
1283 </p>\r
1284 </li>\r
1285 </ul></div>\r
1286 </div>\r
1287 </div>\r
1288 </div>\r
1289 <div class="sect1">\r
1290 <h2 id="_ccache_3_2_1">ccache 3.2.1</h2>\r
1291 <div class="sectionbody">\r
1292 <div class="paragraph"><p>Release date: 2014-12-10</p></div>\r
1293 <div class="sect2">\r
1294 <h3 id="_bug_fixes_10">Bug fixes</h3>\r
1295 <div class="ulist"><ul>\r
1296 <li>\r
1297 <p>\r
1298 Fixed regression in temporary file handling, which lead to incorrect\r
1299   permissions for stats, manifest and ccache.conf files in the cache.\r
1300 </p>\r
1301 </li>\r
1302 <li>\r
1303 <p>\r
1304 <code>CACHEDIR.TAG</code> files are now created in the [0-9a-f] subdirectories so that\r
1305   ccache.conf is not lost in backups.\r
1306 </p>\r
1307 </li>\r
1308 <li>\r
1309 <p>\r
1310 Made the default cache size suffix <code>G</code>, as previously documented.\r
1311 </p>\r
1312 </li>\r
1313 <li>\r
1314 <p>\r
1315 <code>-fdiagnostics-color=auto</code> is now passed to the compiler even if stderr is\r
1316   redirected. This fixes a problem when, for instance, a configure test probes\r
1317   if the compiler (wrapped via ccache) supports <code>-fdiagnostics-color=auto</code>.\r
1318 </p>\r
1319 </li>\r
1320 <li>\r
1321 <p>\r
1322 Added missing documentation for <code>max_files</code> and <code>max_size</code> configuration\r
1323   options.\r
1324 </p>\r
1325 </li>\r
1326 </ul></div>\r
1327 </div>\r
1328 </div>\r
1329 </div>\r
1330 <div class="sect1">\r
1331 <h2 id="_ccache_3_2">ccache 3.2</h2>\r
1332 <div class="sectionbody">\r
1333 <div class="paragraph"><p>Release date: 2014-11-17</p></div>\r
1334 <div class="sect2">\r
1335 <h3 id="_new_features_and_improvements_5">New features and improvements</h3>\r
1336 <div class="ulist"><ul>\r
1337 <li>\r
1338 <p>\r
1339 Added support for configuring ccache via one or several configuration files\r
1340   instead of via environment variables. Environment variables still have\r
1341   priority but are no longer the recommended way of customizing ccache\r
1342   behavior. See the manual for more information.\r
1343 </p>\r
1344 </li>\r
1345 <li>\r
1346 <p>\r
1347 Added support for compiler error/warning messages with color.\r
1348 </p>\r
1349 </li>\r
1350 <li>\r
1351 <p>\r
1352 Made creation of temporary directories and cache directories smarter to avoid\r
1353   unnecessary <code>stat</code> calls.\r
1354 </p>\r
1355 </li>\r
1356 <li>\r
1357 <p>\r
1358 Improved efficiency of the algorithm that scans for <code>__DATE_</code> and <code>__TIME__</code>\r
1359   tokens in the hashed source code.\r
1360 </p>\r
1361 </li>\r
1362 <li>\r
1363 <p>\r
1364 Added support for several binaries (separated by space) in <code>CCACHE_PREFIX</code>.\r
1365 </p>\r
1366 </li>\r
1367 <li>\r
1368 <p>\r
1369 The <code>-c</code> option is no longer passed to the preprocessor. This fixes problems\r
1370   with clang and Solaris&#8217;s C++ compiler.\r
1371 </p>\r
1372 </li>\r
1373 <li>\r
1374 <p>\r
1375 ccache no longer passes preprocessor options like <code>-D</code> and <code>-I</code> to the\r
1376   compiler when compiling preprocessed output. This fixes warnings emitted by\r
1377   clang.\r
1378 </p>\r
1379 </li>\r
1380 <li>\r
1381 <p>\r
1382 Compiler options <code>-fprofile-generate</code>, <code>-fprofile-arcs</code>, <code>-fprofile-use</code> and\r
1383   <code>-fbranch-probabilities</code> are now handled without bailing.\r
1384 </p>\r
1385 </li>\r
1386 <li>\r
1387 <p>\r
1388 Added support for clang&#8217;s <code>--serialize-diagnostic</code> option, storing the\r
1389   diagnostic file (<code>.dia</code>) in the cache.\r
1390 </p>\r
1391 </li>\r
1392 <li>\r
1393 <p>\r
1394 Added support for precompiled headers when using clang.\r
1395 </p>\r
1396 </li>\r
1397 <li>\r
1398 <p>\r
1399 Added support for clang <code>.pth</code> (pretokenized header) files.\r
1400 </p>\r
1401 </li>\r
1402 <li>\r
1403 <p>\r
1404 Changed the <code>-x</code> language option to use the new objective C standard for GCC\r
1405   and clang.\r
1406 </p>\r
1407 </li>\r
1408 <li>\r
1409 <p>\r
1410 On a cache miss, ccache now instructs the compiler to create the object file\r
1411   at the real destination and then copies the file into the cache instead of\r
1412   the other way around. This is needed to support compiler options like\r
1413   <code>-fprofile-arcs</code> and <code>--serialize-diagnostics</code>.\r
1414 </p>\r
1415 </li>\r
1416 <li>\r
1417 <p>\r
1418 ccache now checks that included files' ctimes aren&#8217;t too new. This check can\r
1419   be turned off by adding <code>include_file_ctime</code> to the &#8220;ccache sloppiness&#8221;\r
1420   setting.\r
1421 </p>\r
1422 </li>\r
1423 <li>\r
1424 <p>\r
1425 Added possibility to get cache hits based on filename, size, mtime and ctime\r
1426   only. On other words, source code files are not even read, only stat-ed. This\r
1427   operation mode is opt-in by adding <code>file_stat_matches</code> to the &#8220;ccache\r
1428   sloppiness&#8221; setting.\r
1429 </p>\r
1430 </li>\r
1431 <li>\r
1432 <p>\r
1433 The filename part of options like <code>-Wp,-MDfilename</code> is no longer included in\r
1434   the hash since the filename doesn&#8217;t have any bearing on the result.\r
1435 </p>\r
1436 </li>\r
1437 <li>\r
1438 <p>\r
1439 Added a &#8220;read-only direct&#8221; configuration setting, which is like the\r
1440   ordinary read-only setting except that ccache will only try to retrieve\r
1441   results from the cache using the direct mode, not the preprocessor mode.\r
1442 </p>\r
1443 </li>\r
1444 <li>\r
1445 <p>\r
1446 The display and interpretation of cache size has been changed to use SI\r
1447   units.\r
1448 </p>\r
1449 </li>\r
1450 <li>\r
1451 <p>\r
1452 Default cache size is now 5 GB (was previously 1 GiB).\r
1453 </p>\r
1454 </li>\r
1455 <li>\r
1456 <p>\r
1457 Added configuration option to set the compression level of compressed object\r
1458   files in the cache.\r
1459 </p>\r
1460 </li>\r
1461 <li>\r
1462 <p>\r
1463 Added support for <code>@file</code> and <code>-@file</code> arguments (reading options from a\r
1464   file).\r
1465 </p>\r
1466 </li>\r
1467 <li>\r
1468 <p>\r
1469 <code>-Wl,</code> options are no longer included in the hash since they don&#8217;t affect\r
1470   compilation.\r
1471 </p>\r
1472 </li>\r
1473 <li>\r
1474 <p>\r
1475 Bail out on too hard compiler option <code>-Wp,-P</code>.\r
1476 </p>\r
1477 </li>\r
1478 <li>\r
1479 <p>\r
1480 Optimized MD4 calculation code on little-endian systems.\r
1481 </p>\r
1482 </li>\r
1483 <li>\r
1484 <p>\r
1485 Various improvements and fixes on win32.\r
1486 </p>\r
1487 </li>\r
1488 <li>\r
1489 <p>\r
1490 Improved logging to the ccache log file.\r
1491 </p>\r
1492 </li>\r
1493 <li>\r
1494 <p>\r
1495 Added <code>--dump-manifest</code> command-line option for debugging purposes.\r
1496 </p>\r
1497 </li>\r
1498 <li>\r
1499 <p>\r
1500 Added <code>--with-bundled-zlib</code> configure option.\r
1501 </p>\r
1502 </li>\r
1503 <li>\r
1504 <p>\r
1505 Upgraded bundled zlib to version 1.2.8.\r
1506 </p>\r
1507 </li>\r
1508 <li>\r
1509 <p>\r
1510 Improved <code>dev.mk</code> to be more platform independent.\r
1511 </p>\r
1512 </li>\r
1513 <li>\r
1514 <p>\r
1515 Made the test suite work with clang and gcc-llvm on OS X.\r
1516 </p>\r
1517 </li>\r
1518 <li>\r
1519 <p>\r
1520 Various other improvements of the test suite.\r
1521 </p>\r
1522 </li>\r
1523 </ul></div>\r
1524 </div>\r
1525 <div class="sect2">\r
1526 <h3 id="_bug_fixes_11">Bug fixes</h3>\r
1527 <div class="ulist"><ul>\r
1528 <li>\r
1529 <p>\r
1530 Any previous <code>.stderr</code> is now removed from the cache when recaching.\r
1531 </p>\r
1532 </li>\r
1533 <li>\r
1534 <p>\r
1535 Fixed an issue when handling the <code>-arch</code> compiler option with an argument.\r
1536 </p>\r
1537 </li>\r
1538 <li>\r
1539 <p>\r
1540 Fixed race condition when creating the initial cache directory.\r
1541 </p>\r
1542 </li>\r
1543 <li>\r
1544 <p>\r
1545 Fixed test suite failures when <code>CC</code> is a ccache-wrapped compiler.\r
1546 </p>\r
1547 </li>\r
1548 </ul></div>\r
1549 </div>\r
1550 </div>\r
1551 </div>\r
1552 <div class="sect1">\r
1553 <h2 id="_ccache_3_1_12">ccache 3.1.12</h2>\r
1554 <div class="sectionbody">\r
1555 <div class="paragraph"><p>Release date: 2016-07-12</p></div>\r
1556 <div class="sect2">\r
1557 <h3 id="_bug_fixes_12">Bug fixes</h3>\r
1558 <div class="ulist"><ul>\r
1559 <li>\r
1560 <p>\r
1561 Fixed a bug where (due to ccache rewriting paths) the compiler could choose\r
1562   incorrect include files if <code>CCACHE_BASEDIR</code> is used and the source file path\r
1563   is absolute and is a symlink.\r
1564 </p>\r
1565 </li>\r
1566 </ul></div>\r
1567 </div>\r
1568 </div>\r
1569 </div>\r
1570 <div class="sect1">\r
1571 <h2 id="_ccache_3_1_11">ccache 3.1.11</h2>\r
1572 <div class="sectionbody">\r
1573 <div class="paragraph"><p>Release date: 2015-03-07</p></div>\r
1574 <div class="sect2">\r
1575 <h3 id="_bug_fixes_13">Bug fixes</h3>\r
1576 <div class="ulist"><ul>\r
1577 <li>\r
1578 <p>\r
1579 Fixed bug which could result in false cache hits when source code contains\r
1580   <code>'"'</code> followed by <code>" /*"</code> or <code>" //"</code> (with variations).\r
1581 </p>\r
1582 </li>\r
1583 <li>\r
1584 <p>\r
1585 Made hash of cached result created with and without <code>CCACHE_CPP2</code> different.\r
1586   This makes it possible to rebuild with <code>CCACHE_CPP2</code> set without having to\r
1587   clear the cache to get new results.\r
1588 </p>\r
1589 </li>\r
1590 <li>\r
1591 <p>\r
1592 Don&#8217;t try to reset a non-existing stats file. This avoids &#8220;No such file or\r
1593   directory&#8221; messages in the ccache log when the cache directory doesn&#8217;t\r
1594   exist.\r
1595 </p>\r
1596 </li>\r
1597 </ul></div>\r
1598 </div>\r
1599 </div>\r
1600 </div>\r
1601 <div class="sect1">\r
1602 <h2 id="_ccache_3_1_10">ccache 3.1.10</h2>\r
1603 <div class="sectionbody">\r
1604 <div class="paragraph"><p>Release date: 2014-10-19</p></div>\r
1605 <div class="sect2">\r
1606 <h3 id="_new_features_and_improvements_6">New features and improvements</h3>\r
1607 <div class="ulist"><ul>\r
1608 <li>\r
1609 <p>\r
1610 Added support for the <code>-Xclang</code> compiler option.\r
1611 </p>\r
1612 </li>\r
1613 <li>\r
1614 <p>\r
1615 Improved handling of exit code of internally executed processes.\r
1616 </p>\r
1617 </li>\r
1618 <li>\r
1619 <p>\r
1620 Zero length object files in the cache are now rejected as invalid.\r
1621 </p>\r
1622 </li>\r
1623 <li>\r
1624 <p>\r
1625 Bail out on option <code>-gsplit-dwarf</code> (since it produces multiple output files).\r
1626 </p>\r
1627 </li>\r
1628 <li>\r
1629 <p>\r
1630 Compiler option <code>-fdebug-prefix-map</code> is now ignored (not part of the hash).\r
1631   (The <code>-fdebug-prefix-map</code> option may be used in combination with\r
1632   <code>CCACHE_BASEDIR</code> to reuse results across different directories.)\r
1633 </p>\r
1634 </li>\r
1635 <li>\r
1636 <p>\r
1637 Added note in documentation that <code>--ccache-skip</code> currently does not mean\r
1638   &#8220;don&#8217;t hash the following option&#8221;.\r
1639 </p>\r
1640 </li>\r
1641 <li>\r
1642 <p>\r
1643 To enable support for precompiled headers (PCH), <code>CCACHE_SLOPPINESS</code> now also\r
1644   needs to include the new <code>pch_defines</code> sloppiness. This is because ccache\r
1645   can&#8217;t detect changes in the source code when only defined macros have been\r
1646   changed.\r
1647 </p>\r
1648 </li>\r
1649 <li>\r
1650 <p>\r
1651 Stale files in the internal temporary directory (<code>&lt;ccache_dir&gt;/tmp</code>) are now\r
1652   cleaned up if they are older than one hour.\r
1653 </p>\r
1654 </li>\r
1655 </ul></div>\r
1656 </div>\r
1657 <div class="sect2">\r
1658 <h3 id="_bug_fixes_14">Bug fixes</h3>\r
1659 <div class="ulist"><ul>\r
1660 <li>\r
1661 <p>\r
1662 Fixed path canonicalization in <code>make_relative_path()</code> when path doesn&#8217;t\r
1663   exist.\r
1664 </p>\r
1665 </li>\r
1666 <li>\r
1667 <p>\r
1668 Fixed bug in <code>common_dir_prefix_length()</code>. This corrects the <code>CCACHE_BASEDIR</code>\r
1669   behavior.\r
1670 </p>\r
1671 </li>\r
1672 <li>\r
1673 <p>\r
1674 ccache no longer tries to create the cache directory when <code>CCACHE_DISABLE</code> is\r
1675   set.\r
1676 </p>\r
1677 </li>\r
1678 <li>\r
1679 <p>\r
1680 Fixed bug when reading manifests with a very large number of file info\r
1681   entries.\r
1682 </p>\r
1683 </li>\r
1684 <li>\r
1685 <p>\r
1686 Fixed problem with logging of current working directory.\r
1687 </p>\r
1688 </li>\r
1689 </ul></div>\r
1690 </div>\r
1691 </div>\r
1692 </div>\r
1693 <div class="sect1">\r
1694 <h2 id="_ccache_3_1_9">ccache 3.1.9</h2>\r
1695 <div class="sectionbody">\r
1696 <div class="paragraph"><p>Release date: 2013-01-06</p></div>\r
1697 <div class="sect2">\r
1698 <h3 id="_bug_fixes_15">Bug fixes</h3>\r
1699 <div class="ulist"><ul>\r
1700 <li>\r
1701 <p>\r
1702 The EAGAIN signal is now handled correctly when emitting cached stderr\r
1703   output. This fixes a problem triggered by large error outputs from the\r
1704   compiler.\r
1705 </p>\r
1706 </li>\r
1707 <li>\r
1708 <p>\r
1709 Subdirectories in the cache are no longer created in read-only mode.\r
1710 </p>\r
1711 </li>\r
1712 <li>\r
1713 <p>\r
1714 Fixed so that ccache&#8217;s log file descriptor is not made available to the\r
1715   compiler.\r
1716 </p>\r
1717 </li>\r
1718 <li>\r
1719 <p>\r
1720 Improved error reporting when failing to create temporary stdout/stderr files\r
1721   when executing the compiler.\r
1722 </p>\r
1723 </li>\r
1724 <li>\r
1725 <p>\r
1726 Disappearing temporary stdout/stderr files are now handled gracefully.\r
1727 </p>\r
1728 </li>\r
1729 </ul></div>\r
1730 </div>\r
1731 <div class="sect2">\r
1732 <h3 id="_other">Other</h3>\r
1733 <div class="ulist"><ul>\r
1734 <li>\r
1735 <p>\r
1736 Fixed test suite to work on ecryptfs.\r
1737 </p>\r
1738 </li>\r
1739 </ul></div>\r
1740 </div>\r
1741 </div>\r
1742 </div>\r
1743 <div class="sect1">\r
1744 <h2 id="_ccache_3_1_8">ccache 3.1.8</h2>\r
1745 <div class="sectionbody">\r
1746 <div class="paragraph"><p>Release date: 2012-08-11</p></div>\r
1747 <div class="sect2">\r
1748 <h3 id="_new_features_and_improvements_7">New features and improvements</h3>\r
1749 <div class="ulist"><ul>\r
1750 <li>\r
1751 <p>\r
1752 Made paths to dependency files relative in order to increase cache hits.\r
1753 </p>\r
1754 </li>\r
1755 <li>\r
1756 <p>\r
1757 Added work-around to make ccache work with buggy GCC 4.1 when creating a\r
1758   pre-compiled header.\r
1759 </p>\r
1760 </li>\r
1761 <li>\r
1762 <p>\r
1763 Clang plugins are now hashed to catch plugin upgrades.\r
1764 </p>\r
1765 </li>\r
1766 </ul></div>\r
1767 </div>\r
1768 <div class="sect2">\r
1769 <h3 id="_bug_fixes_16">Bug fixes</h3>\r
1770 <div class="ulist"><ul>\r
1771 <li>\r
1772 <p>\r
1773 Fixed crash when the current working directory has been removed.\r
1774 </p>\r
1775 </li>\r
1776 <li>\r
1777 <p>\r
1778 Fixed crash when stderr is closed.\r
1779 </p>\r
1780 </li>\r
1781 <li>\r
1782 <p>\r
1783 Corrected a corner case when parsing backslash escapes in string\r
1784   literals.\r
1785 </p>\r
1786 </li>\r
1787 <li>\r
1788 <p>\r
1789 Paths are now correctly canonicalized when computing paths relative to the\r
1790   base directory.\r
1791 </p>\r
1792 </li>\r
1793 </ul></div>\r
1794 </div>\r
1795 <div class="sect2">\r
1796 <h3 id="_other_2">Other</h3>\r
1797 <div class="ulist"><ul>\r
1798 <li>\r
1799 <p>\r
1800 Made git version macro work when compiling outside of the source directory.\r
1801 </p>\r
1802 </li>\r
1803 <li>\r
1804 <p>\r
1805 Fixed <code>static_assert</code> macro definition clash with GCC 4.7.\r
1806 </p>\r
1807 </li>\r
1808 </ul></div>\r
1809 </div>\r
1810 </div>\r
1811 </div>\r
1812 <div class="sect1">\r
1813 <h2 id="_ccache_3_1_7">ccache 3.1.7</h2>\r
1814 <div class="sectionbody">\r
1815 <div class="paragraph"><p>Release date: 2012-01-08</p></div>\r
1816 <div class="sect2">\r
1817 <h3 id="_bug_fixes_17">Bug fixes</h3>\r
1818 <div class="ulist"><ul>\r
1819 <li>\r
1820 <p>\r
1821 Non-writable <code>CCACHE_DIR</code> is now handled gracefully when <code>CCACHE_READONLY</code> is\r
1822   set.\r
1823 </p>\r
1824 </li>\r
1825 <li>\r
1826 <p>\r
1827 Made failure to create files (typically due to bad directory permissions) in\r
1828   the cache directory fatal. Previously, such failures were silently and\r
1829   erroneously flagged as "compiler produced stdout".\r
1830 </p>\r
1831 </li>\r
1832 <li>\r
1833 <p>\r
1834 Both the <code>-specs=file</code> and <code>--specs=file</code> forms are now recognized.\r
1835 </p>\r
1836 </li>\r
1837 <li>\r
1838 <p>\r
1839 Added recognition and hashing of GCC plugins specified with <code>-fplugin=file</code>.\r
1840 </p>\r
1841 </li>\r
1842 <li>\r
1843 <p>\r
1844 <code>CCACHE_COMPILERCHECK</code> now also determines how to hash explicit specs files\r
1845   (<code>-specs=file</code>).\r
1846 </p>\r
1847 </li>\r
1848 <li>\r
1849 <p>\r
1850 Added <code>CPATH</code>, <code>C_INCLUDE_PATH</code> and similar environment variables to the hash\r
1851   to avoid false cache hits when such variables have changed.\r
1852 </p>\r
1853 </li>\r
1854 <li>\r
1855 <p>\r
1856 Corrected log message when unify mode is enabled.\r
1857 </p>\r
1858 </li>\r
1859 <li>\r
1860 <p>\r
1861 Reverted the GCC bug compatibility introduced in ccache 3.1.5 for <code>-MT</code>/<code>-MQ</code>\r
1862   options with concatenated arguments. (The bug is fixed in recent GCC\r
1863   versions.)\r
1864 </p>\r
1865 </li>\r
1866 </ul></div>\r
1867 </div>\r
1868 <div class="sect2">\r
1869 <h3 id="_other_3">Other</h3>\r
1870 <div class="ulist"><ul>\r
1871 <li>\r
1872 <p>\r
1873 Corrected license header for <code>mdfour.c</code>.\r
1874 </p>\r
1875 </li>\r
1876 <li>\r
1877 <p>\r
1878 Improved documentation on how to fix bad object files in the cache.\r
1879 </p>\r
1880 </li>\r
1881 </ul></div>\r
1882 </div>\r
1883 </div>\r
1884 </div>\r
1885 <div class="sect1">\r
1886 <h2 id="_ccache_3_1_6">ccache 3.1.6</h2>\r
1887 <div class="sectionbody">\r
1888 <div class="paragraph"><p>Release date: 2011-08-21</p></div>\r
1889 <div class="sect2">\r
1890 <h3 id="_new_features_and_improvements_8">New features and improvements</h3>\r
1891 <div class="ulist"><ul>\r
1892 <li>\r
1893 <p>\r
1894 Rewrite argument to <code>--sysroot</code> if <code>CCACHE_BASEDIR</code> is used.\r
1895 </p>\r
1896 </li>\r
1897 </ul></div>\r
1898 </div>\r
1899 <div class="sect2">\r
1900 <h3 id="_bug_fixes_18">Bug fixes</h3>\r
1901 <div class="ulist"><ul>\r
1902 <li>\r
1903 <p>\r
1904 Don&#8217;t crash if <code>getcwd()</code> fails.\r
1905 </p>\r
1906 </li>\r
1907 <li>\r
1908 <p>\r
1909 Fixed alignment of &#8220;called for preprocessing&#8221; counter.\r
1910 </p>\r
1911 </li>\r
1912 </ul></div>\r
1913 </div>\r
1914 </div>\r
1915 </div>\r
1916 <div class="sect1">\r
1917 <h2 id="_ccache_3_1_5">ccache 3.1.5</h2>\r
1918 <div class="sectionbody">\r
1919 <div class="paragraph"><p>Release date: 2011-05-29</p></div>\r
1920 <div class="sect2">\r
1921 <h3 id="_new_features_and_improvements_9">New features and improvements</h3>\r
1922 <div class="ulist"><ul>\r
1923 <li>\r
1924 <p>\r
1925 Added a new statistics counter named &#8220;called for preprocessing&#8221;.\r
1926 </p>\r
1927 </li>\r
1928 <li>\r
1929 <p>\r
1930 The original command line is now logged to the file specified with\r
1931   <code>CCACHE_LOGFILE</code>.\r
1932 </p>\r
1933 </li>\r
1934 <li>\r
1935 <p>\r
1936 Improved error logging when system calls fail.\r
1937 </p>\r
1938 </li>\r
1939 <li>\r
1940 <p>\r
1941 Added support for rewriting absolute paths in <code>-F</code>/<code>-iframework</code> GCC\r
1942   options.\r
1943 </p>\r
1944 </li>\r
1945 <li>\r
1946 <p>\r
1947 Improved order of statistics counters in <code>ccache -s</code> output.\r
1948 </p>\r
1949 </li>\r
1950 </ul></div>\r
1951 </div>\r
1952 <div class="sect2">\r
1953 <h3 id="_bug_fixes_19">Bug fixes</h3>\r
1954 <div class="ulist"><ul>\r
1955 <li>\r
1956 <p>\r
1957 The <code>-MF</code>/<code>-MT</code>/<code>-MQ</code> options with concatenated argument are now handled\r
1958   correctly when they are last on the command line.\r
1959 </p>\r
1960 </li>\r
1961 <li>\r
1962 <p>\r
1963 ccache is now bug compatible with GCC for the <code>-MT</code>/<code>-MQ</code> options with\r
1964   concatenated arguments.\r
1965 </p>\r
1966 </li>\r
1967 <li>\r
1968 <p>\r
1969 Fixed a minor memory leak.\r
1970 </p>\r
1971 </li>\r
1972 <li>\r
1973 <p>\r
1974 Systems that lack (and don&#8217;t need to be linked with) libm are now supported.\r
1975 </p>\r
1976 </li>\r
1977 </ul></div>\r
1978 </div>\r
1979 </div>\r
1980 </div>\r
1981 <div class="sect1">\r
1982 <h2 id="_ccache_3_1_4">ccache 3.1.4</h2>\r
1983 <div class="sectionbody">\r
1984 <div class="paragraph"><p>Release date: 2011-01-09</p></div>\r
1985 <div class="sect2">\r
1986 <h3 id="_bug_fixes_20">Bug fixes</h3>\r
1987 <div class="ulist"><ul>\r
1988 <li>\r
1989 <p>\r
1990 Made a work-around for a bug in <code>gzputc()</code> in zlib 1.2.5.\r
1991 </p>\r
1992 </li>\r
1993 <li>\r
1994 <p>\r
1995 Corrupt manifest files are now removed so that they won&#8217;t block direct mode\r
1996   hits.\r
1997 </p>\r
1998 </li>\r
1999 <li>\r
2000 <p>\r
2001 ccache now copes with file systems that don&#8217;t know about symbolic links.\r
2002 </p>\r
2003 </li>\r
2004 <li>\r
2005 <p>\r
2006 The file handle in now correctly closed on write error when trying to create\r
2007   a cache dir tag.\r
2008 </p>\r
2009 </li>\r
2010 </ul></div>\r
2011 </div>\r
2012 </div>\r
2013 </div>\r
2014 <div class="sect1">\r
2015 <h2 id="_ccache_3_1_3">ccache 3.1.3</h2>\r
2016 <div class="sectionbody">\r
2017 <div class="paragraph"><p>Release date: 2010-11-28</p></div>\r
2018 <div class="sect2">\r
2019 <h3 id="_bug_fixes_21">Bug fixes</h3>\r
2020 <div class="ulist"><ul>\r
2021 <li>\r
2022 <p>\r
2023 The -MFarg, -MTarg and -MQarg compiler options (i.e, without space between\r
2024   option and argument) are now handled correctly.\r
2025 </p>\r
2026 </li>\r
2027 </ul></div>\r
2028 </div>\r
2029 <div class="sect2">\r
2030 <h3 id="_other_4">Other</h3>\r
2031 <div class="ulist"><ul>\r
2032 <li>\r
2033 <p>\r
2034 Portability fixes for HP-UX 11.00 and other esoteric systems.\r
2035 </p>\r
2036 </li>\r
2037 </ul></div>\r
2038 </div>\r
2039 </div>\r
2040 </div>\r
2041 <div class="sect1">\r
2042 <h2 id="_ccache_3_1_2">ccache 3.1.2</h2>\r
2043 <div class="sectionbody">\r
2044 <div class="paragraph"><p>Release date: 2010-11-21</p></div>\r
2045 <div class="sect2">\r
2046 <h3 id="_bug_fixes_22">Bug fixes</h3>\r
2047 <div class="ulist"><ul>\r
2048 <li>\r
2049 <p>\r
2050 Bail out on too hard compiler options <code>-fdump-*</code>.\r
2051 </p>\r
2052 </li>\r
2053 <li>\r
2054 <p>\r
2055 NULL return values from malloc/calloc of zero bytes are now handled\r
2056   correctly.\r
2057 </p>\r
2058 </li>\r
2059 <li>\r
2060 <p>\r
2061 Fixed issue when parsing precompiler output on AIX.\r
2062 </p>\r
2063 </li>\r
2064 </ul></div>\r
2065 </div>\r
2066 <div class="sect2">\r
2067 <h3 id="_other_5">Other</h3>\r
2068 <div class="ulist"><ul>\r
2069 <li>\r
2070 <p>\r
2071 Improved documentation on which information is included in the hash sum.\r
2072 </p>\r
2073 </li>\r
2074 <li>\r
2075 <p>\r
2076 Made the &#8220;too new header file&#8221; test case work on file systems with\r
2077   unsynchronized clocks.\r
2078 </p>\r
2079 </li>\r
2080 <li>\r
2081 <p>\r
2082 The test suite now also works on systems that lack a /dev/zero.\r
2083 </p>\r
2084 </li>\r
2085 </ul></div>\r
2086 </div>\r
2087 </div>\r
2088 </div>\r
2089 <div class="sect1">\r
2090 <h2 id="_ccache_3_1_1">ccache 3.1.1</h2>\r
2091 <div class="sectionbody">\r
2092 <div class="paragraph"><p>Release date: 2010-11-07</p></div>\r
2093 <div class="sect2">\r
2094 <h3 id="_bug_fixes_23">Bug fixes</h3>\r
2095 <div class="ulist"><ul>\r
2096 <li>\r
2097 <p>\r
2098 ccache now falls back to preprocessor mode when a non-regular include file\r
2099   (device, socket, etc) has been detected so that potential hanging due to\r
2100   blocking reads is avoided.\r
2101 </p>\r
2102 </li>\r
2103 <li>\r
2104 <p>\r
2105 CRC errors are now detected when decompressing compressed files in the cache.\r
2106 </p>\r
2107 </li>\r
2108 <li>\r
2109 <p>\r
2110 Fixed potential object file corruption race on NFS.\r
2111 </p>\r
2112 </li>\r
2113 <li>\r
2114 <p>\r
2115 Minor documentation corrections.\r
2116 </p>\r
2117 </li>\r
2118 <li>\r
2119 <p>\r
2120 Fixed configure detection of ar.\r
2121 </p>\r
2122 </li>\r
2123 <li>\r
2124 <p>\r
2125 ccache development version (set by dev.mk) now works with gits whose\r
2126   <code>describe</code> command doesn&#8217;t understand <code>--dirty</code>.\r
2127 </p>\r
2128 </li>\r
2129 </ul></div>\r
2130 </div>\r
2131 <div class="sect2">\r
2132 <h3 id="_other_6">Other</h3>\r
2133 <div class="ulist"><ul>\r
2134 <li>\r
2135 <p>\r
2136 Minor debug log message improvements.\r
2137 </p>\r
2138 </li>\r
2139 </ul></div>\r
2140 </div>\r
2141 </div>\r
2142 </div>\r
2143 <div class="sect1">\r
2144 <h2 id="_ccache_3_1">ccache 3.1</h2>\r
2145 <div class="sectionbody">\r
2146 <div class="paragraph"><p>Release date: 2010-09-16</p></div>\r
2147 <div class="sect2">\r
2148 <h3 id="_new_features_and_improvements_10">New features and improvements</h3>\r
2149 <div class="ulist"><ul>\r
2150 <li>\r
2151 <p>\r
2152 Added support for hashing the output of a custom command (e.g. <code>%compiler%\r
2153   --version</code>) to identify the compiler instead of stat-ing or hashing the\r
2154   compiler binary. This can improve robustness when the compiler (as seen by\r
2155   ccache) actually isn&#8217;t the real compiler but another compiler wrapper.\r
2156 </p>\r
2157 </li>\r
2158 <li>\r
2159 <p>\r
2160 Added support for caching compilations that use precompiled headers. (See the\r
2161   manual for important instructions regarding this.)\r
2162 </p>\r
2163 </li>\r
2164 <li>\r
2165 <p>\r
2166 Locking of the files containing statistics counters is now done using\r
2167   symlinks instead of POSIX locks. This should make ccache behave a lot better\r
2168   on file systems where POSIX locks are slow or broken (e.g. NFS on some\r
2169   systems).\r
2170 </p>\r
2171 </li>\r
2172 <li>\r
2173 <p>\r
2174 Manifest files are now updated without the need of taking locks.\r
2175 </p>\r
2176 </li>\r
2177 <li>\r
2178 <p>\r
2179 Updates of statistics counters are now always done in one of the sub-level\r
2180   statistics files. This reduces lock contention, which especially improves\r
2181   performance on slow NFS mounts.\r
2182 </p>\r
2183 </li>\r
2184 <li>\r
2185 <p>\r
2186 Reading and writing of statistics counters has been made forward-compatible\r
2187   (unknown counters are retained).\r
2188 </p>\r
2189 </li>\r
2190 <li>\r
2191 <p>\r
2192 Files are now read without using <code>mmap()</code>. This has two benefits: it&#8217;s more\r
2193   robust against file changes during reading and it improves performance on\r
2194   poor systems where <code>mmap()</code> doesn&#8217;t use the disk cache.\r
2195 </p>\r
2196 </li>\r
2197 <li>\r
2198 <p>\r
2199 Added <code>.cp</code> and <code>.CP</code> as known C++ suffixes.\r
2200 </p>\r
2201 </li>\r
2202 <li>\r
2203 <p>\r
2204 Improved logging.\r
2205 </p>\r
2206 </li>\r
2207 <li>\r
2208 <p>\r
2209 Added <code>-install_name</code> as an option known to take an argument. (This improves\r
2210   statistics when using the Darwin linker.)\r
2211 </p>\r
2212 </li>\r
2213 </ul></div>\r
2214 </div>\r
2215 <div class="sect2">\r
2216 <h3 id="_bug_fixes_24">Bug fixes</h3>\r
2217 <div class="ulist"><ul>\r
2218 <li>\r
2219 <p>\r
2220 Non-fatal error messages are now never printed to stderr but logged instead.\r
2221 </p>\r
2222 </li>\r
2223 <li>\r
2224 <p>\r
2225 Fixed a bug affecting failing commands when <code>--ccache-skip</code> is used.\r
2226 </p>\r
2227 </li>\r
2228 <li>\r
2229 <p>\r
2230 Made <code>--ccache-skip</code> work for all options.\r
2231 </p>\r
2232 </li>\r
2233 <li>\r
2234 <p>\r
2235 EINTR is now handled correctly.\r
2236 </p>\r
2237 </li>\r
2238 </ul></div>\r
2239 </div>\r
2240 <div class="sect2">\r
2241 <h3 id="_other_7">Other</h3>\r
2242 <div class="ulist"><ul>\r
2243 <li>\r
2244 <p>\r
2245 Work on porting ccache to win32 (native), mostly done by Ramiro Polla. The\r
2246   port is not yet finished, but will hopefully be complete in some subsequent\r
2247   release.\r
2248 </p>\r
2249 </li>\r
2250 <li>\r
2251 <p>\r
2252 Added a <code>--nostats</code> flag to the performance benchmark program.\r
2253 </p>\r
2254 </li>\r
2255 <li>\r
2256 <p>\r
2257 Made the performance benchmark program more accurate when measuring cache\r
2258   hits.\r
2259 </p>\r
2260 </li>\r
2261 <li>\r
2262 <p>\r
2263 Added a new test framework for unit tests written in C.\r
2264 </p>\r
2265 </li>\r
2266 <li>\r
2267 <p>\r
2268 Got rid of <code>configure-dev</code>; dev mode is now given by <code>dev.mk.in</code> presence.\r
2269 </p>\r
2270 </li>\r
2271 <li>\r
2272 <p>\r
2273 Improved documentation on how to combine ccache with other compiler wrappers\r
2274   (like <code>distcc</code>).\r
2275 </p>\r
2276 </li>\r
2277 <li>\r
2278 <p>\r
2279 New <code>LICENSE.txt</code> file with licensing and copyright details about bundled\r
2280   source code.\r
2281 </p>\r
2282 </li>\r
2283 <li>\r
2284 <p>\r
2285 New <code>AUTHORS.txt</code> file with a list of ccache contributors.\r
2286 </p>\r
2287 </li>\r
2288 <li>\r
2289 <p>\r
2290 New <code>HACKING.txt</code> file with some notes about ccache code conventions.\r
2291 </p>\r
2292 </li>\r
2293 </ul></div>\r
2294 </div>\r
2295 </div>\r
2296 </div>\r
2297 <div class="sect1">\r
2298 <h2 id="_ccache_3_0_1">ccache 3.0.1</h2>\r
2299 <div class="sectionbody">\r
2300 <div class="paragraph"><p>Release date: 2010-07-15</p></div>\r
2301 <div class="sect2">\r
2302 <h3 id="_bug_fixes_25">Bug fixes</h3>\r
2303 <div class="ulist"><ul>\r
2304 <li>\r
2305 <p>\r
2306 The statistics counter &#8220;called for link&#8221; is now correctly updated when\r
2307   linking with a single object file.\r
2308 </p>\r
2309 </li>\r
2310 <li>\r
2311 <p>\r
2312 Fixed a problem with out-of-source builds.\r
2313 </p>\r
2314 </li>\r
2315 </ul></div>\r
2316 </div>\r
2317 </div>\r
2318 </div>\r
2319 <div class="sect1">\r
2320 <h2 id="_ccache_3_0">ccache 3.0</h2>\r
2321 <div class="sectionbody">\r
2322 <div class="paragraph"><p>Release date: 2010-06-20</p></div>\r
2323 <div class="sect2">\r
2324 <h3 id="_general">General</h3>\r
2325 <div class="ulist"><ul>\r
2326 <li>\r
2327 <p>\r
2328 ccache is now licensed under the GNU General Public License (GPL) version 3\r
2329   or later.\r
2330 </p>\r
2331 </li>\r
2332 </ul></div>\r
2333 </div>\r
2334 <div class="sect2">\r
2335 <h3 id="_upgrade_notes">Upgrade notes</h3>\r
2336 <div class="ulist"><ul>\r
2337 <li>\r
2338 <p>\r
2339 The way the hashes are calculated has changed, so you won&#8217;t get cache hits\r
2340   for compilation results stored by older ccache versions. Because of this, you\r
2341   might as well clear the old cache directory with <code>ccache --clear</code> if you\r
2342   want, unless you plan to keep using an older ccache version.\r
2343 </p>\r
2344 </li>\r
2345 </ul></div>\r
2346 </div>\r
2347 <div class="sect2">\r
2348 <h3 id="_new_features_and_improvements_11">New features and improvements</h3>\r
2349 <div class="ulist"><ul>\r
2350 <li>\r
2351 <p>\r
2352 ccache now has a &#8220;direct mode&#8221; where it computes a hash of the source code\r
2353   (including all included files) and compiler options without running the\r
2354   preprocessor. By not running the preprocessor, CPU usage is reduced; the\r
2355   speed is somewhere between 1 and 5 times that of ccache running in\r
2356   traditional mode, depending on the circumstances. The speedup will be higher\r
2357   when I/O is fast (e.g., when files are in the disk cache). The direct mode\r
2358   can be disabled by setting <code>CCACHE_NODIRECT</code>.\r
2359 </p>\r
2360 </li>\r
2361 <li>\r
2362 <p>\r
2363 Support has been added for rewriting absolute paths to relative paths when\r
2364   hashing, in order to increase cache hit rate when building the same source\r
2365   code in different directories even when compiling with <code>-g</code> and when using\r
2366   absolute include directory paths. This is done by setting the\r
2367   <code>CCACHE_BASEDIR</code> environment variable to an absolute path that specifies\r
2368   which paths to rewrite.\r
2369 </p>\r
2370 </li>\r
2371 <li>\r
2372 <p>\r
2373 Object files are now optionally stored compressed in the cache. The runtime\r
2374   cost is negligible, and more files will fit in the ccache directory and in\r
2375   the disk cache. Set <code>CCACHE_COMPRESS</code> to enable object file compression. Note\r
2376   that you can&#8217;t use compression in combination with the hard link feature.\r
2377 </p>\r
2378 </li>\r
2379 <li>\r
2380 <p>\r
2381 A <code>CCACHE_COMPILERCHECK</code> option has been added. This option tells ccache what\r
2382   compiler-identifying information to hash to ensure that results retrieved\r
2383   from the cache are accurate. Possible values are: none (don&#8217;t hash anything),\r
2384   mtime (hash the compiler&#8217;s mtime and size) and content (hash the content of\r
2385   the compiler binary). The default is mtime.\r
2386 </p>\r
2387 </li>\r
2388 <li>\r
2389 <p>\r
2390 It is now possible to specify extra files whose contents should be included\r
2391   in the hash sum by setting the <code>CCACHE_EXTRAFILES</code> option.\r
2392 </p>\r
2393 </li>\r
2394 <li>\r
2395 <p>\r
2396 Added support for Objective-C and Objective-C++. The statistics counter\r
2397   &#8220;not a C/C++ file&#8221; has been renamed to &#8220;unsupported source language&#8221;.\r
2398 </p>\r
2399 </li>\r
2400 <li>\r
2401 <p>\r
2402 Added support for the <code>-x</code> compiler option.\r
2403 </p>\r
2404 </li>\r
2405 <li>\r
2406 <p>\r
2407 Added support for long command-line options.\r
2408 </p>\r
2409 </li>\r
2410 <li>\r
2411 <p>\r
2412 A <code>CACHEDIR.TAG</code> file is now created in the cache directory. See\r
2413   <a href="http://www.brynosaurus.com/cachedir/">http://www.brynosaurus.com/cachedir/</a>.\r
2414 </p>\r
2415 </li>\r
2416 <li>\r
2417 <p>\r
2418 Messages printed to the debug log (specified by <code>CCACHE_LOGFILE</code>) have been\r
2419   improved.\r
2420 </p>\r
2421 </li>\r
2422 <li>\r
2423 <p>\r
2424 You can relax some checks that ccache does in direct mode by setting\r
2425   <code>CCACHE_SLOPPINESS</code>. See the manual for more information.\r
2426 </p>\r
2427 </li>\r
2428 <li>\r
2429 <p>\r
2430 <code>CCACHE_TEMPDIR</code> no longer needs to be on the same filesystem as\r
2431   <code>CCACHE_DIR</code>.\r
2432 </p>\r
2433 </li>\r
2434 <li>\r
2435 <p>\r
2436 The default value of <code>CCACHE_TEMPDIR</code> has been changed to <code>$CCACHE_DIR/tmp</code>\r
2437   to avoid cluttering the top directory.\r
2438 </p>\r
2439 </li>\r
2440 <li>\r
2441 <p>\r
2442 Temporary files that later will be moved into the cache are now created in\r
2443   the cache directory they will end up in. This makes ccache more friendly to\r
2444   Linux&#8217;s directory layout.\r
2445 </p>\r
2446 </li>\r
2447 <li>\r
2448 <p>\r
2449 Improved the test suite and added tests for most of the new functionality.\r
2450   It&#8217;s now also possible to specify a subset of tests to run.\r
2451 </p>\r
2452 </li>\r
2453 <li>\r
2454 <p>\r
2455 Standard error output from the compiler is now only stored in the cache if\r
2456   it&#8217;s non-empty.\r
2457 </p>\r
2458 </li>\r
2459 <li>\r
2460 <p>\r
2461 If the compiler produces no object file or an empty object file, but gives a\r
2462   zero exit status (could be due to a file system problem, a buggy program\r
2463   specified by <code>CCACHE_PREFIX</code>, etc.), ccache copes with it properly.\r
2464 </p>\r
2465 </li>\r
2466 <li>\r
2467 <p>\r
2468 Added <code>installcheck</code> and <code>distcheck</code> make targets.\r
2469 </p>\r
2470 </li>\r
2471 <li>\r
2472 <p>\r
2473 Clarified cache size limit options' and cleanup semantics.\r
2474 </p>\r
2475 </li>\r
2476 <li>\r
2477 <p>\r
2478 Improved display of cache max size values.\r
2479 </p>\r
2480 </li>\r
2481 <li>\r
2482 <p>\r
2483 The following options are no longer hashed in the preprocessor mode:\r
2484   <code>-imacros</code>, <code>-imultilib</code>, <code>-iprefix</code>, <code>-iquote</code>, <code>-isysroot</code>, <code>-iwithprefix</code>,\r
2485   <code>-iwithprefixbefore</code>, <code>-nostdinc</code>, <code>-nostdinc++</code> and <code>-U</code>.\r
2486 </p>\r
2487 </li>\r
2488 </ul></div>\r
2489 </div>\r
2490 <div class="sect2">\r
2491 <h3 id="_bug_fixes_26">Bug fixes</h3>\r
2492 <div class="ulist"><ul>\r
2493 <li>\r
2494 <p>\r
2495 Various portability improvements.\r
2496 </p>\r
2497 </li>\r
2498 <li>\r
2499 <p>\r
2500 Improved detection of home directory.\r
2501 </p>\r
2502 </li>\r
2503 <li>\r
2504 <p>\r
2505 User-defined <code>CPPFLAGS</code> and <code>LDFLAGS</code> are now respected in the Makefile.\r
2506 </p>\r
2507 </li>\r
2508 <li>\r
2509 <p>\r
2510 Fixed NFS issues.\r
2511 </p>\r
2512 </li>\r
2513 <li>\r
2514 <p>\r
2515 Computation of the hash sum has been improved to decrease the risk of hash\r
2516   collisions. For instance, the compiler options <code>-X -Y</code> and <code>-X-Y</code> previously\r
2517   contributed equally to the hash sum.\r
2518 </p>\r
2519 </li>\r
2520 <li>\r
2521 <p>\r
2522 Bail out on too hard compiler options <code>--coverage</code>, <code>-fprofile-arcs</code>,\r
2523   <code>-fprofile-generate</code>, <code>-fprofile-use</code>, <code>-frepo</code>, <code>-ftest-coverage</code> and\r
2524   <code>-save-temps</code>. Also bail out on <code>@file</code> style options.\r
2525 </p>\r
2526 </li>\r
2527 <li>\r
2528 <p>\r
2529 Errors when using multiple <code>-arch</code> compiler options are now noted as\r
2530   &#8220;unsupported compiler option&#8221;.\r
2531 </p>\r
2532 </li>\r
2533 <li>\r
2534 <p>\r
2535 <code>-MD</code>/<code>-MMD</code> options without <code>-MT</code>/<code>-MF</code> are now handled correctly.\r
2536 </p>\r
2537 </li>\r
2538 <li>\r
2539 <p>\r
2540 The <code>-finput-charset</code> option is now handled correctly.\r
2541 </p>\r
2542 </li>\r
2543 <li>\r
2544 <p>\r
2545 Added support for <code>-Wp,-MD</code> and <code>-Wp,-MMD</code> options.\r
2546 </p>\r
2547 </li>\r
2548 <li>\r
2549 <p>\r
2550 The compiler options <code>-Xassembler</code>, <code>-b</code>, <code>-G</code> and <code>-V</code> are now correctly\r
2551   recognized as taking an argument.\r
2552 </p>\r
2553 </li>\r
2554 <li>\r
2555 <p>\r
2556 Debug information containing line numbers of predefined and command-line\r
2557   macros (enabled with the compiler option <code>-g3</code>) will now be correct.\r
2558 </p>\r
2559 </li>\r
2560 <li>\r
2561 <p>\r
2562 Corrected LRU cleanup handling of object files.\r
2563 </p>\r
2564 </li>\r
2565 <li>\r
2566 <p>\r
2567 <code>utimes()</code> is now used instead of <code>utime()</code> when available.\r
2568 </p>\r
2569 </li>\r
2570 <li>\r
2571 <p>\r
2572 Non-writable cache directories are now handled gracefully.\r
2573 </p>\r
2574 </li>\r
2575 <li>\r
2576 <p>\r
2577 Corrected documentation about sharing the cache directory.\r
2578 </p>\r
2579 </li>\r
2580 <li>\r
2581 <p>\r
2582 Fixed compilation warnings from GCC 4.3.\r
2583 </p>\r
2584 </li>\r
2585 <li>\r
2586 <p>\r
2587 The command specified by <code>CCACHE_PREFIX</code> is no longer part of the hash.\r
2588 </p>\r
2589 </li>\r
2590 <li>\r
2591 <p>\r
2592 Fixed bad memory access spotted by Valgrind.\r
2593 </p>\r
2594 </li>\r
2595 <li>\r
2596 <p>\r
2597 Fixed a bug in <code>x_realloc</code>.\r
2598 </p>\r
2599 </li>\r
2600 <li>\r
2601 <p>\r
2602 Freed memory is no longer referenced when compiling a <code>.i</code>/<code>.ii</code> file and\r
2603   falling back to running the real compiler.\r
2604 </p>\r
2605 </li>\r
2606 <li>\r
2607 <p>\r
2608 The test suite is now immune to external values of the <code>CCACHE_*</code> environment\r
2609   variables.\r
2610 </p>\r
2611 </li>\r
2612 <li>\r
2613 <p>\r
2614 Improved detection of recursive invocation.\r
2615 </p>\r
2616 </li>\r
2617 <li>\r
2618 <p>\r
2619 The ccache binary is now not unconditionally stripped when installing.\r
2620 </p>\r
2621 </li>\r
2622 <li>\r
2623 <p>\r
2624 Statistics counters are now correctly updated for -E option failures and\r
2625   internal errors.\r
2626 </p>\r
2627 </li>\r
2628 </ul></div>\r
2629 </div>\r
2630 </div>\r
2631 </div>\r
2632 </div>\r
2633 <div id="footnotes"><hr /></div>\r
2634 <div id="footer">\r
2635 <div id="footer-text">\r
2636 Version 3.3.1<br />\r
2637 Last updated\r
2638  2016-09-07 21:19:19 CEST\r
2639 </div>\r
2640 </div>\r
2641 </body>\r
2642 </html>\r