Imported Upstream version 3.2.8
[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.2.8</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_2_8">ccache 3.2.8</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 an issue when compiler option <code>-Wp,-MT,path</code> is used instead of <code>-MT\r
754   path</code> (and similar for <code>-MF</code>, <code>-MP</code> and <code>-MQ</code>) and <code>run_second_cpp</code>\r
755   (<code>CCACHE_CPP2</code>) is enabled.\r
756 </p>\r
757 </li>\r
758 <li>\r
759 <p>\r
760 ccache now understands the undocumented <code>-coverage</code> (only one dash) GCC\r
761   option.\r
762 </p>\r
763 </li>\r
764 </ul></div>\r
765 </div>\r
766 </div>\r
767 </div>\r
768 <div class="sect1">\r
769 <h2 id="_ccache_3_2_7">ccache 3.2.7</h2>\r
770 <div class="sectionbody">\r
771 <div class="paragraph"><p>Release date: 2016-07-20</p></div>\r
772 <div class="sect2">\r
773 <h3 id="_bug_fixes_2">Bug fixes</h3>\r
774 <div class="ulist"><ul>\r
775 <li>\r
776 <p>\r
777 Fixed a bug which could lead to false cache hits for compiler command lines\r
778   with a missing argument to an option that takes an argument.\r
779 </p>\r
780 </li>\r
781 <li>\r
782 <p>\r
783 ccache now knows how to work around a glitch in the output of GCC 6&#8217;s\r
784   preprocessor.\r
785 </p>\r
786 </li>\r
787 </ul></div>\r
788 </div>\r
789 </div>\r
790 </div>\r
791 <div class="sect1">\r
792 <h2 id="_ccache_3_2_6">ccache 3.2.6</h2>\r
793 <div class="sectionbody">\r
794 <div class="paragraph"><p>Release date: 2016-07-12</p></div>\r
795 <div class="sect2">\r
796 <h3 id="_bug_fixes_3">Bug fixes</h3>\r
797 <div class="ulist"><ul>\r
798 <li>\r
799 <p>\r
800 Fixed build problem on QNX, which lacks &#8220;SA_RESTART&#8221;.\r
801 </p>\r
802 </li>\r
803 <li>\r
804 <p>\r
805 Bail out on compiler option <code>-fstack-usage</code> since it creates a <code>.su</code> file\r
806   which ccache currently doesn&#8217;t handle.\r
807 </p>\r
808 </li>\r
809 <li>\r
810 <p>\r
811 Fixed a bug where (due to ccache rewriting paths) the compiler could choose\r
812   incorrect include files if <code>CCACHE_BASEDIR</code> is used and the source file path\r
813   is absolute and is a symlink.\r
814 </p>\r
815 </li>\r
816 </ul></div>\r
817 </div>\r
818 </div>\r
819 </div>\r
820 <div class="sect1">\r
821 <h2 id="_ccache_3_2_5">ccache 3.2.5</h2>\r
822 <div class="sectionbody">\r
823 <div class="paragraph"><p>Release date: 2016-04-17</p></div>\r
824 <div class="sect2">\r
825 <h3 id="_new_features_and_improvements">New features and improvements</h3>\r
826 <div class="ulist"><ul>\r
827 <li>\r
828 <p>\r
829 Only pass clang-specific <code>-stdlib=</code> to the preprocessor.\r
830 </p>\r
831 </li>\r
832 <li>\r
833 <p>\r
834 Improved handling of stale NFS handles.\r
835 </p>\r
836 </li>\r
837 <li>\r
838 <p>\r
839 Made it harder to misinterpret documentation of boolean environment settings'\r
840   semantics.\r
841 </p>\r
842 </li>\r
843 </ul></div>\r
844 </div>\r
845 <div class="sect2">\r
846 <h3 id="_bug_fixes_4">Bug fixes</h3>\r
847 <div class="ulist"><ul>\r
848 <li>\r
849 <p>\r
850 Include m4 files used by configure.ac in the source dist archives.\r
851 </p>\r
852 </li>\r
853 <li>\r
854 <p>\r
855 Corrected "Performance" section in the manual regarding <code>__DATE_</code>, <code>__TIME__</code>\r
856   and <code>__FILE__</code> macros.\r
857 </p>\r
858 </li>\r
859 <li>\r
860 <p>\r
861 Fixed build on Solaris 10+ and AIX 7.\r
862 </p>\r
863 </li>\r
864 <li>\r
865 <p>\r
866 Fixed failure to create directories on QNX.\r
867 </p>\r
868 </li>\r
869 <li>\r
870 <p>\r
871 Don&#8217;t (try to) update manifest file in &#8220;read-only&#8221; and &#8220;read-only direct&#8221;\r
872   modes.\r
873 </p>\r
874 </li>\r
875 <li>\r
876 <p>\r
877 Fixed a bug in caching of <code>stat</code> system calls in &#8220;file_stat_matches\r
878   sloppiness mode&#8221;.\r
879 </p>\r
880 </li>\r
881 <li>\r
882 <p>\r
883 Fixed bug in hashing of clang plugins, leading to unnecessary cache misses.\r
884 </p>\r
885 </li>\r
886 <li>\r
887 <p>\r
888 Fixed --print-config to show &#8220;pch_defines sloppiness&#8221;.\r
889 </p>\r
890 </li>\r
891 <li>\r
892 <p>\r
893 The man page is now built when running &#8220;make install&#8221; from Git repository\r
894   sources.\r
895 </p>\r
896 </li>\r
897 </ul></div>\r
898 </div>\r
899 </div>\r
900 </div>\r
901 <div class="sect1">\r
902 <h2 id="_ccache_3_2_4">ccache 3.2.4</h2>\r
903 <div class="sectionbody">\r
904 <div class="paragraph"><p>Release date: 2015-10-08</p></div>\r
905 <div class="sect2">\r
906 <h3 id="_bug_fixes_5">Bug fixes</h3>\r
907 <div class="ulist"><ul>\r
908 <li>\r
909 <p>\r
910 Fixed build error related to zlib on systems with older make versions\r
911   (regression in ccache 3.2.3).\r
912 </p>\r
913 </li>\r
914 <li>\r
915 <p>\r
916 Made conversion-to-bool explicit to avoid build warnings (and potential\r
917   runtime errors) on legacy systems.\r
918 </p>\r
919 </li>\r
920 <li>\r
921 <p>\r
922 Improved signal handling: Kill compiler on SIGTERM; wait for compiler to exit\r
923   before exiting; die appropriately.\r
924 </p>\r
925 </li>\r
926 <li>\r
927 <p>\r
928 Minor fixes related to Windows support.\r
929 </p>\r
930 </li>\r
931 <li>\r
932 <p>\r
933 The correct compression level is now used if compression is requested.\r
934 </p>\r
935 </li>\r
936 <li>\r
937 <p>\r
938 Fixed a bug where cache cleanup could be run too early for caches larger than\r
939   64 GiB on 32-bit systems.\r
940 </p>\r
941 </li>\r
942 </ul></div>\r
943 </div>\r
944 </div>\r
945 </div>\r
946 <div class="sect1">\r
947 <h2 id="_ccache_3_2_3">ccache 3.2.3</h2>\r
948 <div class="sectionbody">\r
949 <div class="paragraph"><p>Release date: 2015-08-16</p></div>\r
950 <div class="sect2">\r
951 <h3 id="_new_features_and_improvements_2">New features and improvements</h3>\r
952 <div class="ulist"><ul>\r
953 <li>\r
954 <p>\r
955 Added support for compiler option <code>-gsplit-dwarf</code>.\r
956 </p>\r
957 </li>\r
958 </ul></div>\r
959 </div>\r
960 <div class="sect2">\r
961 <h3 id="_bug_fixes_6">Bug fixes</h3>\r
962 <div class="ulist"><ul>\r
963 <li>\r
964 <p>\r
965 Support external zlib in nonstandard directory.\r
966 </p>\r
967 </li>\r
968 <li>\r
969 <p>\r
970 Avoid calling <code>exit()</code> inside an exit handler.\r
971 </p>\r
972 </li>\r
973 <li>\r
974 <p>\r
975 Let exit handler terminate properly.\r
976 </p>\r
977 </li>\r
978 <li>\r
979 <p>\r
980 Bail out on compiler option <code>--save-temps</code> in addition to <code>-save-temps</code>.\r
981 </p>\r
982 </li>\r
983 <li>\r
984 <p>\r
985 Only log "Disabling direct mode" once when failing to read potential include\r
986   files.\r
987 </p>\r
988 </li>\r
989 </ul></div>\r
990 </div>\r
991 </div>\r
992 </div>\r
993 <div class="sect1">\r
994 <h2 id="_ccache_3_2_2">ccache 3.2.2</h2>\r
995 <div class="sectionbody">\r
996 <div class="paragraph"><p>Release date: 2015-05-10</p></div>\r
997 <div class="sect2">\r
998 <h3 id="_new_features_and_improvements_3">New features and improvements</h3>\r
999 <div class="ulist"><ul>\r
1000 <li>\r
1001 <p>\r
1002 Added support for <code>CCACHE_COMPILERCHECK=string:&lt;value&gt;</code>. This is a faster\r
1003   alternative to <code>CCACHE_COMPILERCHECK=&lt;command&gt;</code> if the command&#8217;s output can\r
1004   be precalculated by the build system.\r
1005 </p>\r
1006 </li>\r
1007 <li>\r
1008 <p>\r
1009 Add support for caching code coverage results (compiling for gcov).\r
1010 </p>\r
1011 </li>\r
1012 </ul></div>\r
1013 </div>\r
1014 <div class="sect2">\r
1015 <h3 id="_bug_fixes_7">Bug fixes</h3>\r
1016 <div class="ulist"><ul>\r
1017 <li>\r
1018 <p>\r
1019 Made hash of cached result created with and without <code>CCACHE_CPP2</code> different.\r
1020   This makes it possible to rebuild with <code>CCACHE_CPP2</code> set without having to\r
1021   clear the cache to get new results.\r
1022 </p>\r
1023 </li>\r
1024 <li>\r
1025 <p>\r
1026 Don&#8217;t try to reset a non-existing stats file. This avoids &#8220;No such file or\r
1027   directory&#8221; messages in the ccache log when the cache directory doesn&#8217;t\r
1028   exist.\r
1029 </p>\r
1030 </li>\r
1031 <li>\r
1032 <p>\r
1033 Fixed a bug where ccache deleted clang diagnostics after compiler failures.\r
1034 </p>\r
1035 </li>\r
1036 <li>\r
1037 <p>\r
1038 Avoid performing an unnecessary copy of the object file on a cache miss.\r
1039 </p>\r
1040 </li>\r
1041 <li>\r
1042 <p>\r
1043 Bail out on too hard compiler option <code>-fmodules</code>.\r
1044 </p>\r
1045 </li>\r
1046 <li>\r
1047 <p>\r
1048 Bail out on too hard compiler option <code>-fplugin=libcc1plugin</code> (interaction\r
1049   with GDB).\r
1050 </p>\r
1051 </li>\r
1052 <li>\r
1053 <p>\r
1054 Fixed build error when compiling ccache with recent clang versions.\r
1055 </p>\r
1056 </li>\r
1057 <li>\r
1058 <p>\r
1059 Removed signal-unsafe code from signal handler.\r
1060 </p>\r
1061 </li>\r
1062 <li>\r
1063 <p>\r
1064 Corrected logic for when to output cached stderr.\r
1065 </p>\r
1066 </li>\r
1067 <li>\r
1068 <p>\r
1069 Wipe the whole cached result on failure retrieving a cached file.\r
1070 </p>\r
1071 </li>\r
1072 <li>\r
1073 <p>\r
1074 Fixed build error when compiling ccache with recent clang versions.\r
1075 </p>\r
1076 </li>\r
1077 </ul></div>\r
1078 </div>\r
1079 </div>\r
1080 </div>\r
1081 <div class="sect1">\r
1082 <h2 id="_ccache_3_2_1">ccache 3.2.1</h2>\r
1083 <div class="sectionbody">\r
1084 <div class="paragraph"><p>Release date: 2014-12-10</p></div>\r
1085 <div class="sect2">\r
1086 <h3 id="_bug_fixes_8">Bug fixes</h3>\r
1087 <div class="ulist"><ul>\r
1088 <li>\r
1089 <p>\r
1090 Fixed regression in temporary file handling, which lead to incorrect\r
1091   permissions for stats, manifest and ccache.conf files in the cache.\r
1092 </p>\r
1093 </li>\r
1094 <li>\r
1095 <p>\r
1096 <code>CACHEDIR.TAG</code> files are now created in the [0-9a-f] subdirectories so that\r
1097   ccache.conf is not lost in backups.\r
1098 </p>\r
1099 </li>\r
1100 <li>\r
1101 <p>\r
1102 Made the default cache size suffix <code>G</code>, as previously documented.\r
1103 </p>\r
1104 </li>\r
1105 <li>\r
1106 <p>\r
1107 <code>-fdiagnostics-color=auto</code> is now passed to the compiler even if stderr is\r
1108   redirected. This fixes a problem when, for instance, a configure test probes\r
1109   if the compiler (wrapped via ccache) supports <code>-fdiagnostics-color=auto</code>.\r
1110 </p>\r
1111 </li>\r
1112 <li>\r
1113 <p>\r
1114 Added missing documentation for <code>max_files</code> and <code>max_size</code> configuration\r
1115   options.\r
1116 </p>\r
1117 </li>\r
1118 </ul></div>\r
1119 </div>\r
1120 </div>\r
1121 </div>\r
1122 <div class="sect1">\r
1123 <h2 id="_ccache_3_2">ccache 3.2</h2>\r
1124 <div class="sectionbody">\r
1125 <div class="paragraph"><p>Release date: 2014-11-17</p></div>\r
1126 <div class="sect2">\r
1127 <h3 id="_new_features_and_improvements_4">New features and improvements</h3>\r
1128 <div class="ulist"><ul>\r
1129 <li>\r
1130 <p>\r
1131 Added support for configuring ccache via one or several configuration files\r
1132   instead of via environment variables. Environment variables still have\r
1133   priority but are no longer the recommended way of customizing ccache\r
1134   behavior. See the manual for more information.\r
1135 </p>\r
1136 </li>\r
1137 <li>\r
1138 <p>\r
1139 Added support for compiler error/warning messages with color.\r
1140 </p>\r
1141 </li>\r
1142 <li>\r
1143 <p>\r
1144 Made creation of temporary directories and cache directories smarter to avoid\r
1145   unnecessary <code>stat</code> calls.\r
1146 </p>\r
1147 </li>\r
1148 <li>\r
1149 <p>\r
1150 Improved efficiency of the algorithm that scans for <code>__DATE_</code> and <code>__TIME__</code>\r
1151   tokens in the hashed source code.\r
1152 </p>\r
1153 </li>\r
1154 <li>\r
1155 <p>\r
1156 Added support for several binaries (separated by space) in <code>CCACHE_PREFIX</code>.\r
1157 </p>\r
1158 </li>\r
1159 <li>\r
1160 <p>\r
1161 The <code>-c</code> option is no longer passed to the preprocessor. This fixes problems\r
1162   with clang and Solaris&#8217;s C++ compiler.\r
1163 </p>\r
1164 </li>\r
1165 <li>\r
1166 <p>\r
1167 ccache no longer passes preprocessor options like <code>-D</code> and <code>-I</code> to the\r
1168   compiler when compiling preprocessed output. This fixes warnings emitted by\r
1169   clang.\r
1170 </p>\r
1171 </li>\r
1172 <li>\r
1173 <p>\r
1174 Compiler options <code>-fprofile-generate</code>, <code>-fprofile-arcs</code>, <code>-fprofile-use</code> and\r
1175   <code>-fbranch-probabilities</code> are now handled without bailing.\r
1176 </p>\r
1177 </li>\r
1178 <li>\r
1179 <p>\r
1180 Added support for clang&#8217;s <code>--serialize-diagnostic</code> option, storing the\r
1181   diagnostic file (<code>.dia</code>) in the cache.\r
1182 </p>\r
1183 </li>\r
1184 <li>\r
1185 <p>\r
1186 Added support for precompiled headers when using clang.\r
1187 </p>\r
1188 </li>\r
1189 <li>\r
1190 <p>\r
1191 Added support for clang <code>.pth</code> (pretokenized header) files.\r
1192 </p>\r
1193 </li>\r
1194 <li>\r
1195 <p>\r
1196 Changed the <code>-x</code> language option to use the new objective C standard for GCC\r
1197   and clang.\r
1198 </p>\r
1199 </li>\r
1200 <li>\r
1201 <p>\r
1202 On a cache miss, ccache now instructs the compiler to create the object file\r
1203   at the real destination and then copies the file into the cache instead of\r
1204   the other way around. This is needed to support compiler options like\r
1205   <code>-fprofile-arcs</code> and <code>--serialize-diagnostics</code>.\r
1206 </p>\r
1207 </li>\r
1208 <li>\r
1209 <p>\r
1210 ccache now checks that included files' ctimes aren&#8217;t too new. This check can\r
1211   be turned off by adding <code>include_file_ctime</code> to the &#8220;ccache sloppiness&#8221;\r
1212   setting.\r
1213 </p>\r
1214 </li>\r
1215 <li>\r
1216 <p>\r
1217 Added possibility to get cache hits based on filename, size, mtime and ctime\r
1218   only. On other words, source code files are not even read, only stat-ed. This\r
1219   operation mode is opt-in by adding <code>file_stat_matches</code> to the &#8220;ccache\r
1220   sloppiness&#8221; setting.\r
1221 </p>\r
1222 </li>\r
1223 <li>\r
1224 <p>\r
1225 The filename part of options like <code>-Wp,-MDfilename</code> is no longer included in\r
1226   the hash since the filename doesn&#8217;t have any bearing on the result.\r
1227 </p>\r
1228 </li>\r
1229 <li>\r
1230 <p>\r
1231 Added a &#8220;read-only direct&#8221; configuration setting, which is like the\r
1232   ordinary read-only setting except that ccache will only try to retrieve\r
1233   results from the cache using the direct mode, not the preprocessor mode.\r
1234 </p>\r
1235 </li>\r
1236 <li>\r
1237 <p>\r
1238 The display and interpretation of cache size has been changed to use SI\r
1239   units.\r
1240 </p>\r
1241 </li>\r
1242 <li>\r
1243 <p>\r
1244 Default cache size is now 5 GB (was previously 1 GiB).\r
1245 </p>\r
1246 </li>\r
1247 <li>\r
1248 <p>\r
1249 Added configuration option to set the compression level of compressed object\r
1250   files in the cache.\r
1251 </p>\r
1252 </li>\r
1253 <li>\r
1254 <p>\r
1255 Added support for <code>@file</code> and <code>-@file</code> arguments (reading options from a\r
1256   file).\r
1257 </p>\r
1258 </li>\r
1259 <li>\r
1260 <p>\r
1261 <code>-Wl,</code> options are no longer included in the hash since they don&#8217;t affect\r
1262   compilation.\r
1263 </p>\r
1264 </li>\r
1265 <li>\r
1266 <p>\r
1267 Bail out on too hard compiler option <code>-Wp,-P</code>.\r
1268 </p>\r
1269 </li>\r
1270 <li>\r
1271 <p>\r
1272 Optimized MD4 calculation code on little-endian systems.\r
1273 </p>\r
1274 </li>\r
1275 <li>\r
1276 <p>\r
1277 Various improvements and fixes on win32.\r
1278 </p>\r
1279 </li>\r
1280 <li>\r
1281 <p>\r
1282 Improved logging to the ccache log file.\r
1283 </p>\r
1284 </li>\r
1285 <li>\r
1286 <p>\r
1287 Added <code>--dump-manifest</code> command-line option for debugging purposes.\r
1288 </p>\r
1289 </li>\r
1290 <li>\r
1291 <p>\r
1292 Added <code>--with-bundled-zlib</code> configure option.\r
1293 </p>\r
1294 </li>\r
1295 <li>\r
1296 <p>\r
1297 Upgraded bundled zlib to version 1.2.8.\r
1298 </p>\r
1299 </li>\r
1300 <li>\r
1301 <p>\r
1302 Improved <code>dev.mk</code> to be more platform independent.\r
1303 </p>\r
1304 </li>\r
1305 <li>\r
1306 <p>\r
1307 Made the test suite work with clang and gcc-llvm on OS X.\r
1308 </p>\r
1309 </li>\r
1310 <li>\r
1311 <p>\r
1312 Various other improvements of the test suite.\r
1313 </p>\r
1314 </li>\r
1315 </ul></div>\r
1316 </div>\r
1317 <div class="sect2">\r
1318 <h3 id="_bug_fixes_9">Bug fixes</h3>\r
1319 <div class="ulist"><ul>\r
1320 <li>\r
1321 <p>\r
1322 Any previous <code>.stderr</code> is now removed from the cache when recaching.\r
1323 </p>\r
1324 </li>\r
1325 <li>\r
1326 <p>\r
1327 Fixed an issue when handling the <code>-arch</code> compiler option with an argument.\r
1328 </p>\r
1329 </li>\r
1330 <li>\r
1331 <p>\r
1332 Fixed race condition when creating the initial cache directory.\r
1333 </p>\r
1334 </li>\r
1335 <li>\r
1336 <p>\r
1337 Fixed test suite failures when <code>CC</code> is a ccache-wrapped compiler.\r
1338 </p>\r
1339 </li>\r
1340 </ul></div>\r
1341 </div>\r
1342 </div>\r
1343 </div>\r
1344 <div class="sect1">\r
1345 <h2 id="_ccache_3_1_12">ccache 3.1.12</h2>\r
1346 <div class="sectionbody">\r
1347 <div class="paragraph"><p>Release date: 2016-07-12</p></div>\r
1348 <div class="sect2">\r
1349 <h3 id="_bug_fixes_10">Bug fixes</h3>\r
1350 <div class="ulist"><ul>\r
1351 <li>\r
1352 <p>\r
1353 Fixed a bug where (due to ccache rewriting paths) the compiler could choose\r
1354   incorrect include files if <code>CCACHE_BASEDIR</code> is used and the source file path\r
1355   is absolute and is a symlink.\r
1356 </p>\r
1357 </li>\r
1358 </ul></div>\r
1359 </div>\r
1360 </div>\r
1361 </div>\r
1362 <div class="sect1">\r
1363 <h2 id="_ccache_3_1_11">ccache 3.1.11</h2>\r
1364 <div class="sectionbody">\r
1365 <div class="paragraph"><p>Release date: 2015-03-07</p></div>\r
1366 <div class="sect2">\r
1367 <h3 id="_bug_fixes_11">Bug fixes</h3>\r
1368 <div class="ulist"><ul>\r
1369 <li>\r
1370 <p>\r
1371 Fixed bug which could result in false cache hits when source code contains\r
1372   <code>'"'</code> followed by <code>" /*"</code> or <code>" //"</code> (with variations).\r
1373 </p>\r
1374 </li>\r
1375 <li>\r
1376 <p>\r
1377 Made hash of cached result created with and without <code>CCACHE_CPP2</code> different.\r
1378   This makes it possible to rebuild with <code>CCACHE_CPP2</code> set without having to\r
1379   clear the cache to get new results.\r
1380 </p>\r
1381 </li>\r
1382 <li>\r
1383 <p>\r
1384 Don&#8217;t try to reset a non-existing stats file. This avoids &#8220;No such file or\r
1385   directory&#8221; messages in the ccache log when the cache directory doesn&#8217;t\r
1386   exist.\r
1387 </p>\r
1388 </li>\r
1389 </ul></div>\r
1390 </div>\r
1391 </div>\r
1392 </div>\r
1393 <div class="sect1">\r
1394 <h2 id="_ccache_3_1_10">ccache 3.1.10</h2>\r
1395 <div class="sectionbody">\r
1396 <div class="paragraph"><p>Release date: 2014-10-19</p></div>\r
1397 <div class="sect2">\r
1398 <h3 id="_new_features_and_improvements_5">New features and improvements</h3>\r
1399 <div class="ulist"><ul>\r
1400 <li>\r
1401 <p>\r
1402 Added support for the <code>-Xclang</code> compiler option.\r
1403 </p>\r
1404 </li>\r
1405 <li>\r
1406 <p>\r
1407 Improved handling of exit code of internally executed processes.\r
1408 </p>\r
1409 </li>\r
1410 <li>\r
1411 <p>\r
1412 Zero length object files in the cache are now rejected as invalid.\r
1413 </p>\r
1414 </li>\r
1415 <li>\r
1416 <p>\r
1417 Bail out on option <code>-gsplit-dwarf</code> (since it produces multiple output files).\r
1418 </p>\r
1419 </li>\r
1420 <li>\r
1421 <p>\r
1422 Compiler option <code>-fdebug-prefix-map</code> is now ignored (not part of the hash).\r
1423   (The <code>-fdebug-prefix-map</code> option may be used in combination with\r
1424   <code>CCACHE_BASEDIR</code> to reuse results across different directories.)\r
1425 </p>\r
1426 </li>\r
1427 <li>\r
1428 <p>\r
1429 Added note in documentation that <code>--ccache-skip</code> currently does not mean\r
1430   &#8220;don&#8217;t hash the following option&#8221;.\r
1431 </p>\r
1432 </li>\r
1433 <li>\r
1434 <p>\r
1435 To enable support for precompiled headers (PCH), <code>CCACHE_SLOPPINESS</code> now also\r
1436   needs to include the new <code>pch_defines</code> sloppiness. This is because ccache\r
1437   can&#8217;t detect changes in the source code when only defined macros have been\r
1438   changed.\r
1439 </p>\r
1440 </li>\r
1441 <li>\r
1442 <p>\r
1443 Stale files in the internal temporary directory (<code>&lt;ccache_dir&gt;/tmp</code>) are now\r
1444   cleaned up if they are older than one hour.\r
1445 </p>\r
1446 </li>\r
1447 </ul></div>\r
1448 </div>\r
1449 <div class="sect2">\r
1450 <h3 id="_bug_fixes_12">Bug fixes</h3>\r
1451 <div class="ulist"><ul>\r
1452 <li>\r
1453 <p>\r
1454 Fixed path canonicalization in <code>make_relative_path()</code> when path doesn&#8217;t\r
1455   exist.\r
1456 </p>\r
1457 </li>\r
1458 <li>\r
1459 <p>\r
1460 Fixed bug in <code>common_dir_prefix_length()</code>. This corrects the <code>CCACHE_BASEDIR</code>\r
1461   behavior.\r
1462 </p>\r
1463 </li>\r
1464 <li>\r
1465 <p>\r
1466 ccache no longer tries to create the cache directory when <code>CCACHE_DISABLE</code> is\r
1467   set.\r
1468 </p>\r
1469 </li>\r
1470 <li>\r
1471 <p>\r
1472 Fixed bug when reading manifests with a very large number of file info\r
1473   entries.\r
1474 </p>\r
1475 </li>\r
1476 <li>\r
1477 <p>\r
1478 Fixed problem with logging of current working directory.\r
1479 </p>\r
1480 </li>\r
1481 </ul></div>\r
1482 </div>\r
1483 </div>\r
1484 </div>\r
1485 <div class="sect1">\r
1486 <h2 id="_ccache_3_1_9">ccache 3.1.9</h2>\r
1487 <div class="sectionbody">\r
1488 <div class="paragraph"><p>Release date: 2013-01-06</p></div>\r
1489 <div class="sect2">\r
1490 <h3 id="_bug_fixes_13">Bug fixes</h3>\r
1491 <div class="ulist"><ul>\r
1492 <li>\r
1493 <p>\r
1494 The EAGAIN signal is now handled correctly when emitting cached stderr\r
1495   output. This fixes a problem triggered by large error outputs from the\r
1496   compiler.\r
1497 </p>\r
1498 </li>\r
1499 <li>\r
1500 <p>\r
1501 Subdirectories in the cache are no longer created in read-only mode.\r
1502 </p>\r
1503 </li>\r
1504 <li>\r
1505 <p>\r
1506 Fixed so that ccache&#8217;s log file descriptor is not made available to the\r
1507   compiler.\r
1508 </p>\r
1509 </li>\r
1510 <li>\r
1511 <p>\r
1512 Improved error reporting when failing to create temporary stdout/stderr files\r
1513   when executing the compiler.\r
1514 </p>\r
1515 </li>\r
1516 <li>\r
1517 <p>\r
1518 Disappearing temporary stdout/stderr files are now handled gracefully.\r
1519 </p>\r
1520 </li>\r
1521 </ul></div>\r
1522 </div>\r
1523 <div class="sect2">\r
1524 <h3 id="_other">Other</h3>\r
1525 <div class="ulist"><ul>\r
1526 <li>\r
1527 <p>\r
1528 Fixed test suite to work on ecryptfs.\r
1529 </p>\r
1530 </li>\r
1531 </ul></div>\r
1532 </div>\r
1533 </div>\r
1534 </div>\r
1535 <div class="sect1">\r
1536 <h2 id="_ccache_3_1_8">ccache 3.1.8</h2>\r
1537 <div class="sectionbody">\r
1538 <div class="paragraph"><p>Release date: 2012-08-11</p></div>\r
1539 <div class="sect2">\r
1540 <h3 id="_new_features_and_improvements_6">New features and improvements</h3>\r
1541 <div class="ulist"><ul>\r
1542 <li>\r
1543 <p>\r
1544 Made paths to dependency files relative in order to increase cache hits.\r
1545 </p>\r
1546 </li>\r
1547 <li>\r
1548 <p>\r
1549 Added work-around to make ccache work with buggy GCC 4.1 when creating a\r
1550   pre-compiled header.\r
1551 </p>\r
1552 </li>\r
1553 <li>\r
1554 <p>\r
1555 Clang plugins are now hashed to catch plugin upgrades.\r
1556 </p>\r
1557 </li>\r
1558 </ul></div>\r
1559 </div>\r
1560 <div class="sect2">\r
1561 <h3 id="_bug_fixes_14">Bug fixes</h3>\r
1562 <div class="ulist"><ul>\r
1563 <li>\r
1564 <p>\r
1565 Fixed crash when the current working directory has been removed.\r
1566 </p>\r
1567 </li>\r
1568 <li>\r
1569 <p>\r
1570 Fixed crash when stderr is closed.\r
1571 </p>\r
1572 </li>\r
1573 <li>\r
1574 <p>\r
1575 Corrected a corner case when parsing backslash escapes in string\r
1576   literals.\r
1577 </p>\r
1578 </li>\r
1579 <li>\r
1580 <p>\r
1581 Paths are now correctly canonicalized when computing paths relative to the\r
1582   base directory.\r
1583 </p>\r
1584 </li>\r
1585 </ul></div>\r
1586 </div>\r
1587 <div class="sect2">\r
1588 <h3 id="_other_2">Other</h3>\r
1589 <div class="ulist"><ul>\r
1590 <li>\r
1591 <p>\r
1592 Made git version macro work when compiling outside of the source directory.\r
1593 </p>\r
1594 </li>\r
1595 <li>\r
1596 <p>\r
1597 Fixed <code>static_assert</code> macro definition clash with GCC 4.7.\r
1598 </p>\r
1599 </li>\r
1600 </ul></div>\r
1601 </div>\r
1602 </div>\r
1603 </div>\r
1604 <div class="sect1">\r
1605 <h2 id="_ccache_3_1_7">ccache 3.1.7</h2>\r
1606 <div class="sectionbody">\r
1607 <div class="paragraph"><p>Release date: 2012-01-08</p></div>\r
1608 <div class="sect2">\r
1609 <h3 id="_bug_fixes_15">Bug fixes</h3>\r
1610 <div class="ulist"><ul>\r
1611 <li>\r
1612 <p>\r
1613 Non-writable <code>CCACHE_DIR</code> is now handled gracefully when <code>CCACHE_READONLY</code> is\r
1614   set.\r
1615 </p>\r
1616 </li>\r
1617 <li>\r
1618 <p>\r
1619 Made failure to create files (typically due to bad directory permissions) in\r
1620   the cache directory fatal. Previously, such failures were silently and\r
1621   erroneously flagged as "compiler produced stdout".\r
1622 </p>\r
1623 </li>\r
1624 <li>\r
1625 <p>\r
1626 Both the <code>-specs=file</code> and <code>--specs=file</code> forms are now recognized.\r
1627 </p>\r
1628 </li>\r
1629 <li>\r
1630 <p>\r
1631 Added recognition and hashing of GCC plugins specified with <code>-fplugin=file</code>.\r
1632 </p>\r
1633 </li>\r
1634 <li>\r
1635 <p>\r
1636 <code>CCACHE_COMPILERCHECK</code> now also determines how to hash explicit specs files\r
1637   (<code>-specs=file</code>).\r
1638 </p>\r
1639 </li>\r
1640 <li>\r
1641 <p>\r
1642 Added <code>CPATH</code>, <code>C_INCLUDE_PATH</code> and similar environment variables to the hash\r
1643   to avoid false cache hits when such variables have changed.\r
1644 </p>\r
1645 </li>\r
1646 <li>\r
1647 <p>\r
1648 Corrected log message when unify mode is enabled.\r
1649 </p>\r
1650 </li>\r
1651 <li>\r
1652 <p>\r
1653 Reverted the GCC bug compatibility introduced in ccache 3.1.5 for <code>-MT</code>/<code>-MQ</code>\r
1654   options with concatenated arguments. (The bug is fixed in recent GCC\r
1655   versions.)\r
1656 </p>\r
1657 </li>\r
1658 </ul></div>\r
1659 </div>\r
1660 <div class="sect2">\r
1661 <h3 id="_other_3">Other</h3>\r
1662 <div class="ulist"><ul>\r
1663 <li>\r
1664 <p>\r
1665 Corrected license header for <code>mdfour.c</code>.\r
1666 </p>\r
1667 </li>\r
1668 <li>\r
1669 <p>\r
1670 Improved documentation on how to fix bad object files in the cache.\r
1671 </p>\r
1672 </li>\r
1673 </ul></div>\r
1674 </div>\r
1675 </div>\r
1676 </div>\r
1677 <div class="sect1">\r
1678 <h2 id="_ccache_3_1_6">ccache 3.1.6</h2>\r
1679 <div class="sectionbody">\r
1680 <div class="paragraph"><p>Release date: 2011-08-21</p></div>\r
1681 <div class="sect2">\r
1682 <h3 id="_new_features_and_improvements_7">New features and improvements</h3>\r
1683 <div class="ulist"><ul>\r
1684 <li>\r
1685 <p>\r
1686 Rewrite argument to <code>--sysroot</code> if <code>CCACHE_BASEDIR</code> is used.\r
1687 </p>\r
1688 </li>\r
1689 </ul></div>\r
1690 </div>\r
1691 <div class="sect2">\r
1692 <h3 id="_bug_fixes_16">Bug fixes</h3>\r
1693 <div class="ulist"><ul>\r
1694 <li>\r
1695 <p>\r
1696 Don&#8217;t crash if <code>getcwd()</code> fails.\r
1697 </p>\r
1698 </li>\r
1699 <li>\r
1700 <p>\r
1701 Fixed alignment of &#8220;called for preprocessing&#8221; counter.\r
1702 </p>\r
1703 </li>\r
1704 </ul></div>\r
1705 </div>\r
1706 </div>\r
1707 </div>\r
1708 <div class="sect1">\r
1709 <h2 id="_ccache_3_1_5">ccache 3.1.5</h2>\r
1710 <div class="sectionbody">\r
1711 <div class="paragraph"><p>Release date: 2011-05-29</p></div>\r
1712 <div class="sect2">\r
1713 <h3 id="_new_features_and_improvements_8">New features and improvements</h3>\r
1714 <div class="ulist"><ul>\r
1715 <li>\r
1716 <p>\r
1717 Added a new statistics counter named &#8220;called for preprocessing&#8221;.\r
1718 </p>\r
1719 </li>\r
1720 <li>\r
1721 <p>\r
1722 The original command line is now logged to the file specified with\r
1723   <code>CCACHE_LOGFILE</code>.\r
1724 </p>\r
1725 </li>\r
1726 <li>\r
1727 <p>\r
1728 Improved error logging when system calls fail.\r
1729 </p>\r
1730 </li>\r
1731 <li>\r
1732 <p>\r
1733 Added support for rewriting absolute paths in <code>-F</code>/<code>-iframework</code> GCC\r
1734   options.\r
1735 </p>\r
1736 </li>\r
1737 <li>\r
1738 <p>\r
1739 Improved order of statistics counters in <code>ccache -s</code> output.\r
1740 </p>\r
1741 </li>\r
1742 </ul></div>\r
1743 </div>\r
1744 <div class="sect2">\r
1745 <h3 id="_bug_fixes_17">Bug fixes</h3>\r
1746 <div class="ulist"><ul>\r
1747 <li>\r
1748 <p>\r
1749 The <code>-MF</code>/<code>-MT</code>/<code>-MQ</code> options with concatenated argument are now handled\r
1750   correctly when they are last on the command line.\r
1751 </p>\r
1752 </li>\r
1753 <li>\r
1754 <p>\r
1755 ccache is now bug compatible with GCC for the <code>-MT</code>/<code>-MQ</code> options with\r
1756   concatenated arguments.\r
1757 </p>\r
1758 </li>\r
1759 <li>\r
1760 <p>\r
1761 Fixed a minor memory leak.\r
1762 </p>\r
1763 </li>\r
1764 <li>\r
1765 <p>\r
1766 Systems that lack (and don&#8217;t need to be linked with) libm are now supported.\r
1767 </p>\r
1768 </li>\r
1769 </ul></div>\r
1770 </div>\r
1771 </div>\r
1772 </div>\r
1773 <div class="sect1">\r
1774 <h2 id="_ccache_3_1_4">ccache 3.1.4</h2>\r
1775 <div class="sectionbody">\r
1776 <div class="paragraph"><p>Release date: 2011-01-09</p></div>\r
1777 <div class="sect2">\r
1778 <h3 id="_bug_fixes_18">Bug fixes</h3>\r
1779 <div class="ulist"><ul>\r
1780 <li>\r
1781 <p>\r
1782 Made a work-around for a bug in <code>gzputc()</code> in zlib 1.2.5.\r
1783 </p>\r
1784 </li>\r
1785 <li>\r
1786 <p>\r
1787 Corrupt manifest files are now removed so that they won&#8217;t block direct mode\r
1788   hits.\r
1789 </p>\r
1790 </li>\r
1791 <li>\r
1792 <p>\r
1793 ccache now copes with file systems that don&#8217;t know about symbolic links.\r
1794 </p>\r
1795 </li>\r
1796 <li>\r
1797 <p>\r
1798 The file handle in now correctly closed on write error when trying to create\r
1799   a cache dir tag.\r
1800 </p>\r
1801 </li>\r
1802 </ul></div>\r
1803 </div>\r
1804 </div>\r
1805 </div>\r
1806 <div class="sect1">\r
1807 <h2 id="_ccache_3_1_3">ccache 3.1.3</h2>\r
1808 <div class="sectionbody">\r
1809 <div class="paragraph"><p>Release date: 2010-11-28</p></div>\r
1810 <div class="sect2">\r
1811 <h3 id="_bug_fixes_19">Bug fixes</h3>\r
1812 <div class="ulist"><ul>\r
1813 <li>\r
1814 <p>\r
1815 The -MFarg, -MTarg and -MQarg compiler options (i.e, without space between\r
1816   option and argument) are now handled correctly.\r
1817 </p>\r
1818 </li>\r
1819 </ul></div>\r
1820 </div>\r
1821 <div class="sect2">\r
1822 <h3 id="_other_4">Other</h3>\r
1823 <div class="ulist"><ul>\r
1824 <li>\r
1825 <p>\r
1826 Portability fixes for HP-UX 11.00 and other esoteric systems.\r
1827 </p>\r
1828 </li>\r
1829 </ul></div>\r
1830 </div>\r
1831 </div>\r
1832 </div>\r
1833 <div class="sect1">\r
1834 <h2 id="_ccache_3_1_2">ccache 3.1.2</h2>\r
1835 <div class="sectionbody">\r
1836 <div class="paragraph"><p>Release date: 2010-11-21</p></div>\r
1837 <div class="sect2">\r
1838 <h3 id="_bug_fixes_20">Bug fixes</h3>\r
1839 <div class="ulist"><ul>\r
1840 <li>\r
1841 <p>\r
1842 Bail out on too hard compiler options <code>-fdump-*</code>.\r
1843 </p>\r
1844 </li>\r
1845 <li>\r
1846 <p>\r
1847 NULL return values from malloc/calloc of zero bytes are now handled\r
1848   correctly.\r
1849 </p>\r
1850 </li>\r
1851 <li>\r
1852 <p>\r
1853 Fixed issue when parsing precompiler output on AIX.\r
1854 </p>\r
1855 </li>\r
1856 </ul></div>\r
1857 </div>\r
1858 <div class="sect2">\r
1859 <h3 id="_other_5">Other</h3>\r
1860 <div class="ulist"><ul>\r
1861 <li>\r
1862 <p>\r
1863 Improved documentation on which information is included in the hash sum.\r
1864 </p>\r
1865 </li>\r
1866 <li>\r
1867 <p>\r
1868 Made the &#8220;too new header file&#8221; test case work on file systems with\r
1869   unsynchronized clocks.\r
1870 </p>\r
1871 </li>\r
1872 <li>\r
1873 <p>\r
1874 The test suite now also works on systems that lack a /dev/zero.\r
1875 </p>\r
1876 </li>\r
1877 </ul></div>\r
1878 </div>\r
1879 </div>\r
1880 </div>\r
1881 <div class="sect1">\r
1882 <h2 id="_ccache_3_1_1">ccache 3.1.1</h2>\r
1883 <div class="sectionbody">\r
1884 <div class="paragraph"><p>Release date: 2010-11-07</p></div>\r
1885 <div class="sect2">\r
1886 <h3 id="_bug_fixes_21">Bug fixes</h3>\r
1887 <div class="ulist"><ul>\r
1888 <li>\r
1889 <p>\r
1890 ccache now falls back to preprocessor mode when a non-regular include file\r
1891   (device, socket, etc) has been detected so that potential hanging due to\r
1892   blocking reads is avoided.\r
1893 </p>\r
1894 </li>\r
1895 <li>\r
1896 <p>\r
1897 CRC errors are now detected when decompressing compressed files in the cache.\r
1898 </p>\r
1899 </li>\r
1900 <li>\r
1901 <p>\r
1902 Fixed potential object file corruption race on NFS.\r
1903 </p>\r
1904 </li>\r
1905 <li>\r
1906 <p>\r
1907 Minor documentation corrections.\r
1908 </p>\r
1909 </li>\r
1910 <li>\r
1911 <p>\r
1912 Fixed configure detection of ar.\r
1913 </p>\r
1914 </li>\r
1915 <li>\r
1916 <p>\r
1917 ccache development version (set by dev.mk) now works with gits whose\r
1918   <code>describe</code> command doesn&#8217;t understand <code>--dirty</code>.\r
1919 </p>\r
1920 </li>\r
1921 </ul></div>\r
1922 </div>\r
1923 <div class="sect2">\r
1924 <h3 id="_other_6">Other</h3>\r
1925 <div class="ulist"><ul>\r
1926 <li>\r
1927 <p>\r
1928 Minor debug log message improvements.\r
1929 </p>\r
1930 </li>\r
1931 </ul></div>\r
1932 </div>\r
1933 </div>\r
1934 </div>\r
1935 <div class="sect1">\r
1936 <h2 id="_ccache_3_1">ccache 3.1</h2>\r
1937 <div class="sectionbody">\r
1938 <div class="paragraph"><p>Release date: 2010-09-16</p></div>\r
1939 <div class="sect2">\r
1940 <h3 id="_new_features_and_improvements_9">New features and improvements</h3>\r
1941 <div class="ulist"><ul>\r
1942 <li>\r
1943 <p>\r
1944 Added support for hashing the output of a custom command (e.g. <code>%compiler%\r
1945   --version</code>) to identify the compiler instead of stat-ing or hashing the\r
1946   compiler binary. This can improve robustness when the compiler (as seen by\r
1947   ccache) actually isn&#8217;t the real compiler but another compiler wrapper.\r
1948 </p>\r
1949 </li>\r
1950 <li>\r
1951 <p>\r
1952 Added support for caching compilations that use precompiled headers. (See the\r
1953   manual for important instructions regarding this.)\r
1954 </p>\r
1955 </li>\r
1956 <li>\r
1957 <p>\r
1958 Locking of the files containing statistics counters is now done using\r
1959   symlinks instead of POSIX locks. This should make ccache behave a lot better\r
1960   on file systems where POSIX locks are slow or broken (e.g. NFS on some\r
1961   systems).\r
1962 </p>\r
1963 </li>\r
1964 <li>\r
1965 <p>\r
1966 Manifest files are now updated without the need of taking locks.\r
1967 </p>\r
1968 </li>\r
1969 <li>\r
1970 <p>\r
1971 Updates of statistics counters are now always done in one of the sub-level\r
1972   statistics files. This reduces lock contention, which especially improves\r
1973   performance on slow NFS mounts.\r
1974 </p>\r
1975 </li>\r
1976 <li>\r
1977 <p>\r
1978 Reading and writing of statistics counters has been made forward-compatible\r
1979   (unknown counters are retained).\r
1980 </p>\r
1981 </li>\r
1982 <li>\r
1983 <p>\r
1984 Files are now read without using <code>mmap()</code>. This has two benefits: it&#8217;s more\r
1985   robust against file changes during reading and it improves performance on\r
1986   poor systems where <code>mmap()</code> doesn&#8217;t use the disk cache.\r
1987 </p>\r
1988 </li>\r
1989 <li>\r
1990 <p>\r
1991 Added <code>.cp</code> and <code>.CP</code> as known C++ suffixes.\r
1992 </p>\r
1993 </li>\r
1994 <li>\r
1995 <p>\r
1996 Improved logging.\r
1997 </p>\r
1998 </li>\r
1999 <li>\r
2000 <p>\r
2001 Added <code>-install_name</code> as an option known to take an argument. (This improves\r
2002   statistics when using the Darwin linker.)\r
2003 </p>\r
2004 </li>\r
2005 </ul></div>\r
2006 </div>\r
2007 <div class="sect2">\r
2008 <h3 id="_bug_fixes_22">Bug fixes</h3>\r
2009 <div class="ulist"><ul>\r
2010 <li>\r
2011 <p>\r
2012 Non-fatal error messages are now never printed to stderr but logged instead.\r
2013 </p>\r
2014 </li>\r
2015 <li>\r
2016 <p>\r
2017 Fixed a bug affecting failing commands when <code>--ccache-skip</code> is used.\r
2018 </p>\r
2019 </li>\r
2020 <li>\r
2021 <p>\r
2022 Made <code>--ccache-skip</code> work for all options.\r
2023 </p>\r
2024 </li>\r
2025 <li>\r
2026 <p>\r
2027 EINTR is now handled correctly.\r
2028 </p>\r
2029 </li>\r
2030 </ul></div>\r
2031 </div>\r
2032 <div class="sect2">\r
2033 <h3 id="_other_7">Other</h3>\r
2034 <div class="ulist"><ul>\r
2035 <li>\r
2036 <p>\r
2037 Work on porting ccache to win32 (native), mostly done by Ramiro Polla. The\r
2038   port is not yet finished, but will hopefully be complete in some subsequent\r
2039   release.\r
2040 </p>\r
2041 </li>\r
2042 <li>\r
2043 <p>\r
2044 Added a <code>--nostats</code> flag to the performance benchmark program.\r
2045 </p>\r
2046 </li>\r
2047 <li>\r
2048 <p>\r
2049 Made the performance benchmark program more accurate when measuring cache\r
2050   hits.\r
2051 </p>\r
2052 </li>\r
2053 <li>\r
2054 <p>\r
2055 Added a new test framework for unit tests written in C.\r
2056 </p>\r
2057 </li>\r
2058 <li>\r
2059 <p>\r
2060 Got rid of <code>configure-dev</code>; dev mode is now given by <code>dev.mk.in</code> presence.\r
2061 </p>\r
2062 </li>\r
2063 <li>\r
2064 <p>\r
2065 Improved documentation on how to combine ccache with other compiler wrappers\r
2066   (like <code>distcc</code>).\r
2067 </p>\r
2068 </li>\r
2069 <li>\r
2070 <p>\r
2071 New <code>LICENSE.txt</code> file with licensing and copyright details about bundled\r
2072   source code.\r
2073 </p>\r
2074 </li>\r
2075 <li>\r
2076 <p>\r
2077 New <code>AUTHORS.txt</code> file with a list of ccache contributors.\r
2078 </p>\r
2079 </li>\r
2080 <li>\r
2081 <p>\r
2082 New <code>HACKING.txt</code> file with some notes about ccache code conventions.\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_0_1">ccache 3.0.1</h2>\r
2091 <div class="sectionbody">\r
2092 <div class="paragraph"><p>Release date: 2010-07-15</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 The statistics counter &#8220;called for link&#8221; is now correctly updated when\r
2099   linking with a single object file.\r
2100 </p>\r
2101 </li>\r
2102 <li>\r
2103 <p>\r
2104 Fixed a problem with out-of-source builds.\r
2105 </p>\r
2106 </li>\r
2107 </ul></div>\r
2108 </div>\r
2109 </div>\r
2110 </div>\r
2111 <div class="sect1">\r
2112 <h2 id="_ccache_3_0">ccache 3.0</h2>\r
2113 <div class="sectionbody">\r
2114 <div class="paragraph"><p>Release date: 2010-06-20</p></div>\r
2115 <div class="sect2">\r
2116 <h3 id="_general">General</h3>\r
2117 <div class="ulist"><ul>\r
2118 <li>\r
2119 <p>\r
2120 ccache is now licensed under the GNU General Public License (GPL) version 3\r
2121   or later.\r
2122 </p>\r
2123 </li>\r
2124 </ul></div>\r
2125 </div>\r
2126 <div class="sect2">\r
2127 <h3 id="_upgrade_notes">Upgrade notes</h3>\r
2128 <div class="ulist"><ul>\r
2129 <li>\r
2130 <p>\r
2131 The way the hashes are calculated has changed, so you won&#8217;t get cache hits\r
2132   for compilation results stored by older ccache versions. Because of this, you\r
2133   might as well clear the old cache directory with <code>ccache --clear</code> if you\r
2134   want, unless you plan to keep using an older ccache version.\r
2135 </p>\r
2136 </li>\r
2137 </ul></div>\r
2138 </div>\r
2139 <div class="sect2">\r
2140 <h3 id="_new_features_and_improvements_10">New features and improvements</h3>\r
2141 <div class="ulist"><ul>\r
2142 <li>\r
2143 <p>\r
2144 ccache now has a &#8220;direct mode&#8221; where it computes a hash of the source code\r
2145   (including all included files) and compiler options without running the\r
2146   preprocessor. By not running the preprocessor, CPU usage is reduced; the\r
2147   speed is somewhere between 1 and 5 times that of ccache running in\r
2148   traditional mode, depending on the circumstances. The speedup will be higher\r
2149   when I/O is fast (e.g., when files are in the disk cache). The direct mode\r
2150   can be disabled by setting <code>CCACHE_NODIRECT</code>.\r
2151 </p>\r
2152 </li>\r
2153 <li>\r
2154 <p>\r
2155 Support has been added for rewriting absolute paths to relative paths when\r
2156   hashing, in order to increase cache hit rate when building the same source\r
2157   code in different directories even when compiling with <code>-g</code> and when using\r
2158   absolute include directory paths. This is done by setting the\r
2159   <code>CCACHE_BASEDIR</code> environment variable to an absolute path that specifies\r
2160   which paths to rewrite.\r
2161 </p>\r
2162 </li>\r
2163 <li>\r
2164 <p>\r
2165 Object files are now optionally stored compressed in the cache. The runtime\r
2166   cost is negligible, and more files will fit in the ccache directory and in\r
2167   the disk cache. Set <code>CCACHE_COMPRESS</code> to enable object file compression. Note\r
2168   that you can&#8217;t use compression in combination with the hard link feature.\r
2169 </p>\r
2170 </li>\r
2171 <li>\r
2172 <p>\r
2173 A <code>CCACHE_COMPILERCHECK</code> option has been added. This option tells ccache what\r
2174   compiler-identifying information to hash to ensure that results retrieved\r
2175   from the cache are accurate. Possible values are: none (don&#8217;t hash anything),\r
2176   mtime (hash the compiler&#8217;s mtime and size) and content (hash the content of\r
2177   the compiler binary). The default is mtime.\r
2178 </p>\r
2179 </li>\r
2180 <li>\r
2181 <p>\r
2182 It is now possible to specify extra files whose contents should be included\r
2183   in the hash sum by setting the <code>CCACHE_EXTRAFILES</code> option.\r
2184 </p>\r
2185 </li>\r
2186 <li>\r
2187 <p>\r
2188 Added support for Objective-C and Objective-C++. The statistics counter\r
2189   &#8220;not a C/C++ file&#8221; has been renamed to &#8220;unsupported source language&#8221;.\r
2190 </p>\r
2191 </li>\r
2192 <li>\r
2193 <p>\r
2194 Added support for the <code>-x</code> compiler option.\r
2195 </p>\r
2196 </li>\r
2197 <li>\r
2198 <p>\r
2199 Added support for long command-line options.\r
2200 </p>\r
2201 </li>\r
2202 <li>\r
2203 <p>\r
2204 A <code>CACHEDIR.TAG</code> file is now created in the cache directory. See\r
2205   <a href="http://www.brynosaurus.com/cachedir/">http://www.brynosaurus.com/cachedir/</a>.\r
2206 </p>\r
2207 </li>\r
2208 <li>\r
2209 <p>\r
2210 Messages printed to the debug log (specified by <code>CCACHE_LOGFILE</code>) have been\r
2211   improved.\r
2212 </p>\r
2213 </li>\r
2214 <li>\r
2215 <p>\r
2216 You can relax some checks that ccache does in direct mode by setting\r
2217   <code>CCACHE_SLOPPINESS</code>. See the manual for more information.\r
2218 </p>\r
2219 </li>\r
2220 <li>\r
2221 <p>\r
2222 <code>CCACHE_TEMPDIR</code> no longer needs to be on the same filesystem as\r
2223   <code>CCACHE_DIR</code>.\r
2224 </p>\r
2225 </li>\r
2226 <li>\r
2227 <p>\r
2228 The default value of <code>CCACHE_TEMPDIR</code> has been changed to <code>$CCACHE_DIR/tmp</code>\r
2229   to avoid cluttering the top directory.\r
2230 </p>\r
2231 </li>\r
2232 <li>\r
2233 <p>\r
2234 Temporary files that later will be moved into the cache are now created in\r
2235   the cache directory they will end up in. This makes ccache more friendly to\r
2236   Linux&#8217;s directory layout.\r
2237 </p>\r
2238 </li>\r
2239 <li>\r
2240 <p>\r
2241 Improved the test suite and added tests for most of the new functionality.\r
2242   It&#8217;s now also possible to specify a subset of tests to run.\r
2243 </p>\r
2244 </li>\r
2245 <li>\r
2246 <p>\r
2247 Standard error output from the compiler is now only stored in the cache if\r
2248   it&#8217;s non-empty.\r
2249 </p>\r
2250 </li>\r
2251 <li>\r
2252 <p>\r
2253 If the compiler produces no object file or an empty object file, but gives a\r
2254   zero exit status (could be due to a file system problem, a buggy program\r
2255   specified by <code>CCACHE_PREFIX</code>, etc.), ccache copes with it properly.\r
2256 </p>\r
2257 </li>\r
2258 <li>\r
2259 <p>\r
2260 Added <code>installcheck</code> and <code>distcheck</code> make targets.\r
2261 </p>\r
2262 </li>\r
2263 <li>\r
2264 <p>\r
2265 Clarified cache size limit options' and cleanup semantics.\r
2266 </p>\r
2267 </li>\r
2268 <li>\r
2269 <p>\r
2270 Improved display of cache max size values.\r
2271 </p>\r
2272 </li>\r
2273 <li>\r
2274 <p>\r
2275 The following options are no longer hashed in the preprocessor mode:\r
2276   <code>-imacros</code>, <code>-imultilib</code>, <code>-iprefix</code>, <code>-iquote</code>, <code>-isysroot</code>, <code>-iwithprefix</code>,\r
2277   <code>-iwithprefixbefore</code>, <code>-nostdinc</code>, <code>-nostdinc++</code> and <code>-U</code>.\r
2278 </p>\r
2279 </li>\r
2280 </ul></div>\r
2281 </div>\r
2282 <div class="sect2">\r
2283 <h3 id="_bug_fixes_24">Bug fixes</h3>\r
2284 <div class="ulist"><ul>\r
2285 <li>\r
2286 <p>\r
2287 Various portability improvements.\r
2288 </p>\r
2289 </li>\r
2290 <li>\r
2291 <p>\r
2292 Improved detection of home directory.\r
2293 </p>\r
2294 </li>\r
2295 <li>\r
2296 <p>\r
2297 User-defined <code>CPPFLAGS</code> and <code>LDFLAGS</code> are now respected in the Makefile.\r
2298 </p>\r
2299 </li>\r
2300 <li>\r
2301 <p>\r
2302 Fixed NFS issues.\r
2303 </p>\r
2304 </li>\r
2305 <li>\r
2306 <p>\r
2307 Computation of the hash sum has been improved to decrease the risk of hash\r
2308   collisions. For instance, the compiler options <code>-X -Y</code> and <code>-X-Y</code> previously\r
2309   contributed equally to the hash sum.\r
2310 </p>\r
2311 </li>\r
2312 <li>\r
2313 <p>\r
2314 Bail out on too hard compiler options <code>--coverage</code>, <code>-fprofile-arcs</code>,\r
2315   <code>-fprofile-generate</code>, <code>-fprofile-use</code>, <code>-frepo</code>, <code>-ftest-coverage</code> and\r
2316   <code>-save-temps</code>. Also bail out on <code>@file</code> style options.\r
2317 </p>\r
2318 </li>\r
2319 <li>\r
2320 <p>\r
2321 Errors when using multiple <code>-arch</code> compiler options are now noted as\r
2322   &#8220;unsupported compiler option&#8221;.\r
2323 </p>\r
2324 </li>\r
2325 <li>\r
2326 <p>\r
2327 <code>-MD</code>/<code>-MMD</code> options without <code>-MT</code>/<code>-MF</code> are now handled correctly.\r
2328 </p>\r
2329 </li>\r
2330 <li>\r
2331 <p>\r
2332 The <code>-finput-charset</code> option is now handled correctly.\r
2333 </p>\r
2334 </li>\r
2335 <li>\r
2336 <p>\r
2337 Added support for <code>-Wp,-MD</code> and <code>-Wp,-MMD</code> options.\r
2338 </p>\r
2339 </li>\r
2340 <li>\r
2341 <p>\r
2342 The compiler options <code>-Xassembler</code>, <code>-b</code>, <code>-G</code> and <code>-V</code> are now correctly\r
2343   recognized as taking an argument.\r
2344 </p>\r
2345 </li>\r
2346 <li>\r
2347 <p>\r
2348 Debug information containing line numbers of predefined and command-line\r
2349   macros (enabled with the compiler option <code>-g3</code>) will now be correct.\r
2350 </p>\r
2351 </li>\r
2352 <li>\r
2353 <p>\r
2354 Corrected LRU cleanup handling of object files.\r
2355 </p>\r
2356 </li>\r
2357 <li>\r
2358 <p>\r
2359 <code>utimes()</code> is now used instead of <code>utime()</code> when available.\r
2360 </p>\r
2361 </li>\r
2362 <li>\r
2363 <p>\r
2364 Non-writable cache directories are now handled gracefully.\r
2365 </p>\r
2366 </li>\r
2367 <li>\r
2368 <p>\r
2369 Corrected documentation about sharing the cache directory.\r
2370 </p>\r
2371 </li>\r
2372 <li>\r
2373 <p>\r
2374 Fixed compilation warnings from GCC 4.3.\r
2375 </p>\r
2376 </li>\r
2377 <li>\r
2378 <p>\r
2379 The command specified by <code>CCACHE_PREFIX</code> is no longer part of the hash.\r
2380 </p>\r
2381 </li>\r
2382 <li>\r
2383 <p>\r
2384 Fixed bad memory access spotted by Valgrind.\r
2385 </p>\r
2386 </li>\r
2387 <li>\r
2388 <p>\r
2389 Fixed a bug in <code>x_realloc</code>.\r
2390 </p>\r
2391 </li>\r
2392 <li>\r
2393 <p>\r
2394 Freed memory is no longer referenced when compiling a <code>.i</code>/<code>.ii</code> file and\r
2395   falling back to running the real compiler.\r
2396 </p>\r
2397 </li>\r
2398 <li>\r
2399 <p>\r
2400 The test suite is now immune to external values of the <code>CCACHE_*</code> environment\r
2401   variables.\r
2402 </p>\r
2403 </li>\r
2404 <li>\r
2405 <p>\r
2406 Improved detection of recursive invocation.\r
2407 </p>\r
2408 </li>\r
2409 <li>\r
2410 <p>\r
2411 The ccache binary is now not unconditionally stripped when installing.\r
2412 </p>\r
2413 </li>\r
2414 <li>\r
2415 <p>\r
2416 Statistics counters are now correctly updated for -E option failures and\r
2417   internal errors.\r
2418 </p>\r
2419 </li>\r
2420 </ul></div>\r
2421 </div>\r
2422 </div>\r
2423 </div>\r
2424 </div>\r
2425 <div id="footnotes"><hr /></div>\r
2426 <div id="footer">\r
2427 <div id="footer-text">\r
2428 Version 3.2.8<br />\r
2429 Last updated\r
2430  2016-09-07 20:51:39 CEST\r
2431 </div>\r
2432 </div>\r
2433 </body>\r
2434 </html>\r