/[gentoo]/xml/htdocs/doc/en/handbook/hb-working-features.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/hb-working-features.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.36 Revision 1.37
2<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> 2<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3 3
4<!-- The content of this document is licensed under the CC-BY-SA license --> 4<!-- The content of this document is licensed under the CC-BY-SA license -->
5<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 5<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-features.xml,v 1.36 2008/03/02 17:58:39 rane Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-features.xml,v 1.37 2010/07/13 00:26:59 nightmorph Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<abstract> 11<abstract>
12Discover the features Portage has, such as support for distributed compiling, 12Discover the features Portage has, such as support for distributed compiling,
13ccache and more. 13ccache and more.
14</abstract> 14</abstract>
15 15
16<version>1.32</version> 16<version>1.33</version>
17<date>2008-03-02</date> 17<date>2010-07-12</date>
18 18
19<section> 19<section>
20<title>Portage Features</title> 20<title>Portage Features</title>
21<body> 21<body>
22 22
130<subsection> 130<subsection>
131<title>About ccache</title> 131<title>About ccache</title>
132<body> 132<body>
133 133
134<p> 134<p>
135<c>ccache</c> is a fast compiler cache. When you compile a program, it will 135<c>ccache</c> is a fast compiler cache. When you compile a program, it will
136cache intermediate results so that, whenever you recompile the same program, the 136cache intermediate results so that, whenever you recompile the same program, the
137compilation time is greatly reduced. In common compilations this can result in 5 137compilation time is greatly reduced. The first time you run ccache, it will be
138to 10 times faster compilation times. 138much slower than a normal compilation. Subsequent recompiles should be faster.
139ccache is only helpful if you will be recompiling the same application many
140times; thus it's mostly only useful for software developers.
139</p> 141</p>
140 142
141<p> 143<p>
142If you are interested in the ins and outs of ccache, please visit the 144If you are interested in the ins and outs of ccache, please visit the
143<uri link="http://ccache.samba.org">ccache homepage</uri>. 145<uri link="http://ccache.samba.org">ccache homepage</uri>.
144</p> 146</p>
147
148<warn>
149<c>ccache</c> is known to cause numerous compilation failures. Sometimes ccache
150will retain stale code objects or corrupted files, which can lead to packages
151that cannot be emerged. If this happens (if you receive errors like "File not
152recognized: File truncated"), try recompiling the application with ccache
153disabled (<c>FEATURES="-ccache"</c> in <path>/etc/make.conf</path>)
154<e>before</e> reporting a bug. Unless you are doing development work, <e>do not
155enable ccache</e>.
156</warn>
145 157
146</body> 158</body>
147</subsection> 159</subsection>
148<subsection> 160<subsection>
149<title>Installing ccache</title> 161<title>Installing ccache</title>

Legend:
Removed from v.1.36  
changed lines
  Added in v.1.37

  ViewVC Help
Powered by ViewVC 1.1.20