Gentoo Archives: gentoo-doc-cvs

From: "Joshua Saddler (nightmorph)" <nightmorph@g.o>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-working-features.xml
Date: Tue, 13 Jul 2010 00:27:05
nightmorph    10/07/13 00:26:59

  Modified:             hb-working-features.xml
  redo the ccache section so it's not recommended for everyone. make it clear that it's for folks doing development work, and that ccache is known to cause numerous compile failures. also added a suggestion to disable ccache and recompile before reporting any bugs. bug 327945.

Revision  Changes    Path
1.37                 xml/htdocs/doc/en/handbook/hb-working-features.xml

file :
diff :

Index: hb-working-features.xml
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-features.xml,v
retrieving revision 1.36
retrieving revision 1.37
diff -u -r1.36 -r1.37
--- hb-working-features.xml	2 Mar 2008 17:58:39 -0000	1.36
+++ hb-working-features.xml	13 Jul 2010 00:26:59 -0000	1.37
@@ -4,7 +4,7 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See -->
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-features.xml,v 1.36 2008/03/02 17:58:39 rane Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-features.xml,v 1.37 2010/07/13 00:26:59 nightmorph Exp $ -->
@@ -13,8 +13,8 @@
 ccache and more.
 <title>Portage Features</title>
@@ -132,10 +132,12 @@
-<c>ccache</c> is a fast compiler cache. When you compile a program, it will 
+<c>ccache</c> is a fast compiler cache. When you compile a program, it will
 cache intermediate results so that, whenever you recompile the same program, the
-compilation time is greatly reduced. In common compilations this can result in 5
-to 10 times faster compilation times.
+compilation time is greatly reduced. The first time you run ccache, it will be
+much slower than a normal compilation. Subsequent recompiles should be faster.
+ccache is only helpful if you will be recompiling the same application many
+times; thus it's mostly only useful for software developers.
@@ -143,6 +145,16 @@
 <uri link="">ccache homepage</uri>.
+<c>ccache</c> is known to cause numerous compilation failures. Sometimes ccache
+will retain stale code objects or corrupted files, which can lead to packages
+that cannot be emerged. If this happens (if you receive errors like "File not
+recognized: File truncated"), try recompiling the application with ccache
+disabled (<c>FEATURES="-ccache"</c> in <path>/etc/make.conf</path>)
+<e>before</e> reporting a bug. Unless you are doing development work, <e>do not
+enable ccache</e>.