Gentoo Logo
Gentoo Spaceship




Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-doc-cvs
Navigation:
Lists: gentoo-doc-cvs: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-doc-cvs@g.o
From: "Joshua Saddler (nightmorph)" <nightmorph@g.o>
Subject: gentoo commit in xml/htdocs/doc/en/handbook: hb-working-features.xml
Date: Tue, 13 Jul 2010 00:26:59 +0000 (UTC)
nightmorph    10/07/13 00:26:59

  Modified:             hb-working-features.xml
  Log:
  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 : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-features.xml?rev=1.37&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-features.xml?rev=1.37&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-working-features.xml?r1=1.36&r2=1.37

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 http://creativecommons.org/licenses/by-sa/2.5 -->
 
-<!-- $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 $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 ccache and more.
 </abstract>
 
-<version>1.32</version>
-<date>2008-03-02</date>
+<version>1.33</version>
+<date>2010-07-12</date>
 
 <section>
 <title>Portage Features</title>
@@ -132,10 +132,12 @@
 <body>
 
 <p>
-<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.
 </p>
 
 <p>
@@ -143,6 +145,16 @@
 <uri link="http://ccache.samba.org">ccache homepage</uri>.
 </p>
 
+<warn>
+<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>.
+</warn>
+
 </body>
 </subsection>
 <subsection>





Navigation:
Lists: gentoo-doc-cvs: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
gentoo commit in xml/htdocs/doc/en: gentoo-x86+raid+lvm2-quickinstall.xml
Next by thread:
gentoo commit in xml/htdocs/doc/en/handbook: hb-working-features.xml
Previous by date:
gentoo commit in xml/htdocs/doc/en: gentoo-x86-quickinstall-after-reboot.xml
Next by date:
gentoo commit in xml/htdocs/doc/en/handbook: hb-install-stage.xml hb-install-x86+amd64-kernel.xml


Updated Jun 30, 2012

Summary: Archive of the gentoo-doc-cvs mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.