README.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.3" />\r
   7 <title>ccache README</title>\r
   8 <style type="text/css">\r
   9 /* Sans-serif font. */\r
  10 h1, h2, h3, h4, h5, h6,\r
  11 div.title, caption.title,\r
  12 thead, p.table.header,\r
  13 div#toctitle,\r
  14 span#author, span#revnumber, span#revdate, span#revremark,\r
  15 div#footer {\r
  16   font-family: Arial,Helvetica,sans-serif;\r
  17 }\r
  18 \r
  19 /* Serif font. */\r
  20 div.sectionbody {\r
  21   font-family: Georgia,"Times New Roman",Times,serif;\r
  22 }\r
  23 \r
  24 /* Monospace font. */\r
  25 tt {\r
  26   font-size: inherit;\r
  27 }\r
  28 \r
  29 body {\r
  30   margin: 1em 5% 1em 5%;\r
  31 }\r
  32 \r
  33 a {\r
  34   color: blue;\r
  35   text-decoration: underline;\r
  36 }\r
  37 a:visited {\r
  38   color: fuchsia;\r
  39 }\r
  40 \r
  41 em {\r
  42   font-style: italic;\r
  43   color: navy;\r
  44 }\r
  45 \r
  46 strong {\r
  47   font-weight: bold;\r
  48   color: #083194;\r
  49 }\r
  50 \r
  51 tt {\r
  52   font-size: inherit;\r
  53   color: navy;\r
  54 }\r
  55 \r
  56 h1, h2, h3, h4, h5, h6 {\r
  57   color: #527bbd;\r
  58   margin-top: 1.2em;\r
  59   margin-bottom: 0.5em;\r
  60   line-height: 1.3;\r
  61 }\r
  62 \r
  63 h1, h2, h3 {\r
  64   border-bottom: 2px solid silver;\r
  65 }\r
  66 h2 {\r
  67   padding-top: 0.5em;\r
  68 }\r
  69 h3 {\r
  70   float: left;\r
  71 }\r
  72 h3 + * {\r
  73   clear: left;\r
  74 }\r
  75 \r
  76 div.sectionbody {\r
  77   margin-left: 0;\r
  78 }\r
  79 \r
  80 hr {\r
  81   border: 1px solid silver;\r
  82 }\r
  83 \r
  84 p {\r
  85   margin-top: 0.5em;\r
  86   margin-bottom: 0.5em;\r
  87 }\r
  88 \r
  89 ul, ol, li > p {\r
  90   margin-top: 0;\r
  91 }\r
  92 ul > li     { color: #aaa; }\r
  93 ul > li > * { color: black; }\r
  94 \r
  95 pre {\r
  96   padding: 0;\r
  97   margin: 0;\r
  98 }\r
  99 \r
 100 span#author {\r
 101   color: #527bbd;\r
 102   font-weight: bold;\r
 103   font-size: 1.1em;\r
 104 }\r
 105 span#email {\r
 106 }\r
 107 span#revnumber, span#revdate, span#revremark {\r
 108 }\r
 109 \r
 110 div#footer {\r
 111   font-size: small;\r
 112   border-top: 2px solid silver;\r
 113   padding-top: 0.5em;\r
 114   margin-top: 4.0em;\r
 115 }\r
 116 div#footer-text {\r
 117   float: left;\r
 118   padding-bottom: 0.5em;\r
 119 }\r
 120 div#footer-badges {\r
 121   float: right;\r
 122   padding-bottom: 0.5em;\r
 123 }\r
 124 \r
 125 div#preamble {\r
 126   margin-top: 1.5em;\r
 127   margin-bottom: 1.5em;\r
 128 }\r
 129 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,\r
 130 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,\r
 131 div.admonitionblock {\r
 132   margin-top: 1.0em;\r
 133   margin-bottom: 1.5em;\r
 134 }\r
 135 div.admonitionblock {\r
 136   margin-top: 2.0em;\r
 137   margin-bottom: 2.0em;\r
 138   margin-right: 10%;\r
 139   color: #606060;\r
 140 }\r
 141 \r
 142 div.content { /* Block element content. */\r
 143   padding: 0;\r
 144 }\r
 145 \r
 146 /* Block element titles. */\r
 147 div.title, caption.title {\r
 148   color: #527bbd;\r
 149   font-weight: bold;\r
 150   text-align: left;\r
 151   margin-top: 1.0em;\r
 152   margin-bottom: 0.5em;\r
 153 }\r
 154 div.title + * {\r
 155   margin-top: 0;\r
 156 }\r
 157 \r
 158 td div.title:first-child {\r
 159   margin-top: 0.0em;\r
 160 }\r
 161 div.content div.title:first-child {\r
 162   margin-top: 0.0em;\r
 163 }\r
 164 div.content + div.title {\r
 165   margin-top: 0.0em;\r
 166 }\r
 167 \r
 168 div.sidebarblock > div.content {\r
 169   background: #ffffee;\r
 170   border: 1px solid #dddddd;\r
 171   border-left: 4px solid #f0f0f0;\r
 172   padding: 0.5em;\r
 173 }\r
 174 \r
 175 div.listingblock > div.content {\r
 176   border: 1px solid #dddddd;\r
 177   border-left: 5px solid #f0f0f0;\r
 178   background: #f8f8f8;\r
 179   padding: 0.5em;\r
 180 }\r
 181 \r
 182 div.quoteblock, div.verseblock {\r
 183   padding-left: 1.0em;\r
 184   margin-left: 1.0em;\r
 185   margin-right: 10%;\r
 186   border-left: 5px solid #f0f0f0;\r
 187   color: #777777;\r
 188 }\r
 189 \r
 190 div.quoteblock > div.attribution {\r
 191   padding-top: 0.5em;\r
 192   text-align: right;\r
 193 }\r
 194 \r
 195 div.verseblock > pre.content {\r
 196   font-family: inherit;\r
 197   font-size: inherit;\r
 198 }\r
 199 div.verseblock > div.attribution {\r
 200   padding-top: 0.75em;\r
 201   text-align: left;\r
 202 }\r
 203 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */\r
 204 div.verseblock + div.attribution {\r
 205   text-align: left;\r
 206 }\r
 207 \r
 208 div.admonitionblock .icon {\r
 209   vertical-align: top;\r
 210   font-size: 1.1em;\r
 211   font-weight: bold;\r
 212   text-decoration: underline;\r
 213   color: #527bbd;\r
 214   padding-right: 0.5em;\r
 215 }\r
 216 div.admonitionblock td.content {\r
 217   padding-left: 0.5em;\r
 218   border-left: 3px solid #dddddd;\r
 219 }\r
 220 \r
 221 div.exampleblock > div.content {\r
 222   border-left: 3px solid #dddddd;\r
 223   padding-left: 0.5em;\r
 224 }\r
 225 \r
 226 div.imageblock div.content { padding-left: 0; }\r
 227 span.image img { border-style: none; }\r
 228 a.image:visited { color: white; }\r
 229 \r
 230 dl {\r
 231   margin-top: 0.8em;\r
 232   margin-bottom: 0.8em;\r
 233 }\r
 234 dt {\r
 235   margin-top: 0.5em;\r
 236   margin-bottom: 0;\r
 237   font-style: normal;\r
 238   color: navy;\r
 239 }\r
 240 dd > *:first-child {\r
 241   margin-top: 0.1em;\r
 242 }\r
 243 \r
 244 ul, ol {\r
 245     list-style-position: outside;\r
 246 }\r
 247 ol.arabic {\r
 248   list-style-type: decimal;\r
 249 }\r
 250 ol.loweralpha {\r
 251   list-style-type: lower-alpha;\r
 252 }\r
 253 ol.upperalpha {\r
 254   list-style-type: upper-alpha;\r
 255 }\r
 256 ol.lowerroman {\r
 257   list-style-type: lower-roman;\r
 258 }\r
 259 ol.upperroman {\r
 260   list-style-type: upper-roman;\r
 261 }\r
 262 \r
 263 div.compact ul, div.compact ol,\r
 264 div.compact p, div.compact p,\r
 265 div.compact div, div.compact div {\r
 266   margin-top: 0.1em;\r
 267   margin-bottom: 0.1em;\r
 268 }\r
 269 \r
 270 div.tableblock > table {\r
 271   border: 3px solid #527bbd;\r
 272 }\r
 273 thead, p.table.header {\r
 274   font-weight: bold;\r
 275   color: #527bbd;\r
 276 }\r
 277 tfoot {\r
 278   font-weight: bold;\r
 279 }\r
 280 td > div.verse {\r
 281   white-space: pre;\r
 282 }\r
 283 p.table {\r
 284   margin-top: 0;\r
 285 }\r
 286 /* Because the table frame attribute is overriden by CSS in most browsers. */\r
 287 div.tableblock > table[frame="void"] {\r
 288   border-style: none;\r
 289 }\r
 290 div.tableblock > table[frame="hsides"] {\r
 291   border-left-style: none;\r
 292   border-right-style: none;\r
 293 }\r
 294 div.tableblock > table[frame="vsides"] {\r
 295   border-top-style: none;\r
 296   border-bottom-style: none;\r
 297 }\r
 298 \r
 299 \r
 300 div.hdlist {\r
 301   margin-top: 0.8em;\r
 302   margin-bottom: 0.8em;\r
 303 }\r
 304 div.hdlist tr {\r
 305   padding-bottom: 15px;\r
 306 }\r
 307 dt.hdlist1.strong, td.hdlist1.strong {\r
 308   font-weight: bold;\r
 309 }\r
 310 td.hdlist1 {\r
 311   vertical-align: top;\r
 312   font-style: normal;\r
 313   padding-right: 0.8em;\r
 314   color: navy;\r
 315 }\r
 316 td.hdlist2 {\r
 317   vertical-align: top;\r
 318 }\r
 319 div.hdlist.compact tr {\r
 320   margin: 0;\r
 321   padding-bottom: 0;\r
 322 }\r
 323 \r
 324 .comment {\r
 325   background: yellow;\r
 326 }\r
 327 \r
 328 .footnote, .footnoteref {\r
 329   font-size: 0.8em;\r
 330 }\r
 331 \r
 332 span.footnote, span.footnoteref {\r
 333   vertical-align: super;\r
 334 }\r
 335 \r
 336 #footnotes {\r
 337   margin: 20px 0 20px 0;\r
 338   padding: 7px 0 0 0;\r
 339 }\r
 340 \r
 341 #footnotes div.footnote {\r
 342   margin: 0 0 5px 0;\r
 343 }\r
 344 \r
 345 #footnotes hr {\r
 346   border: none;\r
 347   border-top: 1px solid silver;\r
 348   height: 1px;\r
 349   text-align: left;\r
 350   margin-left: 0;\r
 351   width: 20%;\r
 352   min-width: 100px;\r
 353 }\r
 354 \r
 355 div.colist td {\r
 356   padding-right: 0.5em;\r
 357   padding-bottom: 0.3em;\r
 358   vertical-align: top;\r
 359 }\r
 360 div.colist td img {\r
 361   margin-top: 0.3em;\r
 362 }\r
 363 \r
 364 @media print {\r
 365   div#footer-badges { display: none; }\r
 366 }\r
 367 \r
 368 div#toc {\r
 369   margin-bottom: 2.5em;\r
 370 }\r
 371 \r
 372 div#toctitle {\r
 373   color: #527bbd;\r
 374   font-size: 1.1em;\r
 375   font-weight: bold;\r
 376   margin-top: 1.0em;\r
 377   margin-bottom: 0.1em;\r
 378 }\r
 379 \r
 380 div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {\r
 381   margin-top: 0;\r
 382   margin-bottom: 0;\r
 383 }\r
 384 div.toclevel2 {\r
 385   margin-left: 2em;\r
 386   font-size: 0.9em;\r
 387 }\r
 388 div.toclevel3 {\r
 389   margin-left: 4em;\r
 390   font-size: 0.9em;\r
 391 }\r
 392 div.toclevel4 {\r
 393   margin-left: 6em;\r
 394   font-size: 0.9em;\r
 395 }\r
 396 \r
 397 </style>\r
 398 <script type="text/javascript">\r
 399 /*<![CDATA[*/\r
 400 window.onload = function(){asciidoc.footnotes(); asciidoc.toc(2);}\r
 401 var asciidoc = {  // Namespace.\r
 402 \r
 403 /////////////////////////////////////////////////////////////////////\r
 404 // Table Of Contents generator\r
 405 /////////////////////////////////////////////////////////////////////\r
 406 \r
 407 /* Author: Mihai Bazon, September 2002\r
 408  * http://students.infoiasi.ro/~mishoo\r
 409  *\r
 410  * Table Of Content generator\r
 411  * Version: 0.4\r
 412  *\r
 413  * Feel free to use this script under the terms of the GNU General Public\r
 414  * License, as long as you do not remove or alter this notice.\r
 415  */\r
 416 \r
 417  /* modified by Troy D. Hanson, September 2006. License: GPL */\r
 418  /* modified by Stuart Rackham, 2006, 2009. License: GPL */\r
 419 \r
 420 // toclevels = 1..4.\r
 421 toc: function (toclevels) {\r
 422 \r
 423   function getText(el) {\r
 424     var text = "";\r
 425     for (var i = el.firstChild; i != null; i = i.nextSibling) {\r
 426       if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.\r
 427         text += i.data;\r
 428       else if (i.firstChild != null)\r
 429         text += getText(i);\r
 430     }\r
 431     return text;\r
 432   }\r
 433 \r
 434   function TocEntry(el, text, toclevel) {\r
 435     this.element = el;\r
 436     this.text = text;\r
 437     this.toclevel = toclevel;\r
 438   }\r
 439 \r
 440   function tocEntries(el, toclevels) {\r
 441     var result = new Array;\r
 442     var re = new RegExp('[hH]([2-'+(toclevels+1)+'])');\r
 443     // Function that scans the DOM tree for header elements (the DOM2\r
 444     // nodeIterator API would be a better technique but not supported by all\r
 445     // browsers).\r
 446     var iterate = function (el) {\r
 447       for (var i = el.firstChild; i != null; i = i.nextSibling) {\r
 448         if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {\r
 449           var mo = re.exec(i.tagName);\r
 450           if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {\r
 451             result[result.length] = new TocEntry(i, getText(i), mo[1]-1);\r
 452           }\r
 453           iterate(i);\r
 454         }\r
 455       }\r
 456     }\r
 457     iterate(el);\r
 458     return result;\r
 459   }\r
 460 \r
 461   var toc = document.getElementById("toc");\r
 462   var entries = tocEntries(document.getElementById("content"), toclevels);\r
 463   for (var i = 0; i < entries.length; ++i) {\r
 464     var entry = entries[i];\r
 465     if (entry.element.id == "")\r
 466       entry.element.id = "_toc_" + i;\r
 467     var a = document.createElement("a");\r
 468     a.href = "#" + entry.element.id;\r
 469     a.appendChild(document.createTextNode(entry.text));\r
 470     var div = document.createElement("div");\r
 471     div.appendChild(a);\r
 472     div.className = "toclevel" + entry.toclevel;\r
 473     toc.appendChild(div);\r
 474   }\r
 475   if (entries.length == 0)\r
 476     toc.parentNode.removeChild(toc);\r
 477 },\r
 478 \r
 479 \r
 480 /////////////////////////////////////////////////////////////////////\r
 481 // Footnotes generator\r
 482 /////////////////////////////////////////////////////////////////////\r
 483 \r
 484 /* Based on footnote generation code from:\r
 485  * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html\r
 486  */\r
 487 \r
 488 footnotes: function () {\r
 489   var cont = document.getElementById("content");\r
 490   var noteholder = document.getElementById("footnotes");\r
 491   var spans = cont.getElementsByTagName("span");\r
 492   var refs = {};\r
 493   var n = 0;\r
 494   for (i=0; i<spans.length; i++) {\r
 495     if (spans[i].className == "footnote") {\r
 496       n++;\r
 497       // Use [\s\S] in place of . so multi-line matches work.\r
 498       // Because JavaScript has no s (dotall) regex flag.\r
 499       note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];\r
 500       noteholder.innerHTML +=\r
 501         "<div class='footnote' id='_footnote_" + n + "'>" +\r
 502         "<a href='#_footnoteref_" + n + "' title='Return to text'>" +\r
 503         n + "</a>. " + note + "</div>";\r
 504       spans[i].innerHTML =\r
 505         "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +\r
 506         "' title='View footnote' class='footnote'>" + n + "</a>]";\r
 507       var id =spans[i].getAttribute("id");\r
 508       if (id != null) refs["#"+id] = n;\r
 509     }\r
 510   }\r
 511   if (n == 0)\r
 512     noteholder.parentNode.removeChild(noteholder);\r
 513   else {\r
 514     // Process footnoterefs.\r
 515     for (i=0; i<spans.length; i++) {\r
 516       if (spans[i].className == "footnoteref") {\r
 517         var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");\r
 518         href = href.match(/#.*/)[0];  // Because IE return full URL.\r
 519         n = refs[href];\r
 520         spans[i].innerHTML =\r
 521           "[<a href='#_footnote_" + n +\r
 522           "' title='View footnote' class='footnote'>" + n + "</a>]";\r
 523       }\r
 524     }\r
 525   }\r
 526 }\r
 527 \r
 528 }\r
 529 /*]]>*/\r
 530 </script>\r
 531 </head>\r
 532 <body class="article">\r
 533 <div id="header">\r
 534 <h1>ccache README</h1>\r
 535 <span id="revnumber">version 3.1.6</span>\r
 536 <div id="toc">
 537   <div id="toctitle">Table of Contents</div>
 538   <noscript><p><b>JavaScript must be enabled in your browser to display the table of contents.</b></p></noscript>
 539 </div>\r
 540 </div>\r
 541 <div id="content">\r
 542 <div class="sect1">\r
 543 <h2 id="_about">About</h2>\r
 544 <div class="sectionbody">\r
 545 <div class="paragraph"><p>ccache is a compiler cache. It speeds up recompilation by caching the result of\r
 546 previous compilations and detecting when the same compilation is being done\r
 547 again. Supported languages are C, C<tt>, Objective-C and Objective-C</tt>.</p></div>\r
 548 <div class="paragraph"><p>Please see the manual page and documentation at <a href="http://ccache.samba.org">http://ccache.samba.org</a> for\r
 549 more information.</p></div>\r
 550 </div>\r
 551 </div>\r
 552 <div class="sect1">\r
 553 <h2 id="_documentation">Documentation</h2>\r
 554 <div class="sectionbody">\r
 555 <div class="paragraph"><p>See the ccache(1) man page. It&#8217;s also available as MANUAL.{txt,html}.</p></div>\r
 556 </div>\r
 557 </div>\r
 558 <div class="sect1">\r
 559 <h2 id="_installation">Installation</h2>\r
 560 <div class="sectionbody">\r
 561 <div class="paragraph"><p>See INSTALL.{txt.html}.</p></div>\r
 562 </div>\r
 563 </div>\r
 564 <div class="sect1">\r
 565 <h2 id="_web_site">Web site</h2>\r
 566 <div class="sectionbody">\r
 567 <div class="paragraph"><p>The main ccache web site is here:</p></div>\r
 568 <div class="literalblock">\r
 569 <div class="content">\r
 570 <pre><tt>http://ccache.samba.org</tt></pre>\r
 571 </div></div>\r
 572 </div>\r
 573 </div>\r
 574 <div class="sect1">\r
 575 <h2 id="_mailing_list">Mailing list</h2>\r
 576 <div class="sectionbody">\r
 577 <div class="paragraph"><p>There is a mailing list for discussing usage and development of ccache:</p></div>\r
 578 <div class="literalblock">\r
 579 <div class="content">\r
 580 <pre><tt>http://lists.samba.org/mailman/listinfo/ccache/</tt></pre>\r
 581 </div></div>\r
 582 <div class="paragraph"><p>Anyone is welcome to join.</p></div>\r
 583 </div>\r
 584 </div>\r
 585 <div class="sect1">\r
 586 <h2 id="_bug_reports">Bug reports</h2>\r
 587 <div class="sectionbody">\r
 588 <div class="paragraph"><p>To submit a bug report or to search for existing reports, please visit this web\r
 589 page:</p></div>\r
 590 <div class="literalblock">\r
 591 <div class="content">\r
 592 <pre><tt>http://ccache.samba.org/bugs.html</tt></pre>\r
 593 </div></div>\r
 594 </div>\r
 595 </div>\r
 596 <div class="sect1">\r
 597 <h2 id="_source_code_repository">Source code repository</h2>\r
 598 <div class="sectionbody">\r
 599 <div class="paragraph"><p>To get the very latest version of ccache directly from the source code\r
 600 repository, use git:</p></div>\r
 601 <div class="literalblock">\r
 602 <div class="content">\r
 603 <pre><tt>git clone git://git.samba.org/ccache.git</tt></pre>\r
 604 </div></div>\r
 605 <div class="paragraph"><p>You can also browse the repository:</p></div>\r
 606 <div class="literalblock">\r
 607 <div class="content">\r
 608 <pre><tt>http://gitweb.samba.org/?p=ccache.git</tt></pre>\r
 609 </div></div>\r
 610 </div>\r
 611 </div>\r
 612 <div class="sect1">\r
 613 <h2 id="_history">History</h2>\r
 614 <div class="sectionbody">\r
 615 <div class="paragraph"><p>ccache was originally written by Andrew Tridgell and is currently developed and\r
 616 maintained by Joel Rosdahl. ccache started out as a reimplementation of Erik\r
 617 Thiele&#8217;s &#8220;compilercache&#8221; (see <a href="http://www.erikyyy.de/compilercache/">http://www.erikyyy.de/compilercache/</a>) in C.</p></div>\r
 618 <div class="paragraph"><p>See also NEWS.{txt,html}.</p></div>\r
 619 </div>\r
 620 </div>\r
 621 <div class="sect1">\r
 622 <h2 id="_license_and_copyright">License and copyright</h2>\r
 623 <div class="sectionbody">\r
 624 <div class="paragraph"><p>See LICENSE.{txt,html} and AUTHORS.{txt,html}.</p></div>\r
 625 </div>\r
 626 </div>\r
 627 </div>\r
 628 <div id="footnotes"><hr /></div>\r
 629 <div id="footer">\r
 630 <div id="footer-text">\r
 631 Version 3.1.6<br />\r
 632 Last updated 2010-09-16 19:02:32 CEST\r
 633 </div>\r
 634 </div>\r
 635 </body>\r
 636 </html>\r