From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org)
	by finch.gentoo.org with esmtp (Exim 4.60)
	(envelope-from <gentoo-doc-cvs+bounces-3648-garchives=archives.gentoo.org@lists.gentoo.org>)
	id 1OYTKz-00044z-G5
	for garchives@archives.gentoo.org; Tue, 13 Jul 2010 00:27:05 +0000
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
	by pigeon.gentoo.org (Postfix) with SMTP id 2C410E09E0;
	Tue, 13 Jul 2010 00:27:01 +0000 (UTC)
Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183])
	by pigeon.gentoo.org (Postfix) with ESMTP id BDD8CE09E0
	for <gentoo-doc-cvs@lists.gentoo.org>; Tue, 13 Jul 2010 00:27:00 +0000 (UTC)
Received: from corvid.gentoo.org (corvid.gentoo.org [208.92.234.79])
	(using TLSv1 with cipher ADH-CAMELLIA256-SHA (256/256 bits))
	(No client certificate requested)
	by smtp.gentoo.org (Postfix) with ESMTPS id 525301B4035
	for <gentoo-doc-cvs@lists.gentoo.org>; Tue, 13 Jul 2010 00:27:00 +0000 (UTC)
Received: by corvid.gentoo.org (Postfix, from userid 2104)
	id 847B42CE14; Tue, 13 Jul 2010 00:26:59 +0000 (UTC)
From: "Joshua Saddler (nightmorph)" <nightmorph@gentoo.org>
To: gentoo-doc-cvs@lists.gentoo.org
Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-working-features.xml
X-VCS-Repository: gentoo
X-VCS-Files: hb-working-features.xml
X-VCS-Directories: xml/htdocs/doc/en/handbook
X-VCS-Committer: nightmorph
X-VCS-Committer-Name: Joshua Saddler
Content-Type: text/plain; charset=utf8
Message-Id: <20100713002659.847B42CE14@corvid.gentoo.org>
Date: Tue, 13 Jul 2010 00:26:59 +0000 (UTC)
Precedence: bulk
List-Post: <mailto:gentoo-doc-cvs@lists.gentoo.org>
List-Help: <mailto:gentoo-doc-cvs+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-doc-cvs+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-doc-cvs+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-doc-cvs.gentoo.org>
X-BeenThere: gentoo-doc-cvs@lists.gentoo.org
Reply-to: docs-team@lists.gentoo.org
Content-Transfer-Encoding: quoted-printable
X-Archives-Salt: 96790dc2-5b6b-4d55-8cb7-13122729a6ec
X-Archives-Hash: 698cbdf9e5165c84f7851fc9c377b2de

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 c=
lear that it's for folks doing development work, and that ccache is known=
 to cause numerous compile failures. also added a suggestion to disable c=
cache 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/hand=
book/hb-working-features.xml?rev=3D1.37&view=3Dmarkup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/hand=
book/hb-working-features.xml?rev=3D1.37&content-type=3Dtext/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/hand=
book/hb-working-features.xml?r1=3D1.36&r2=3D1.37

Index: hb-working-features.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-featu=
res.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 -->
=20
-<!-- $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 $ -->
=20
 <sections>
=20
@@ -13,8 +13,8 @@
 ccache and more.
 </abstract>
=20
-<version>1.32</version>
-<date>2008-03-02</date>
+<version>1.33</version>
+<date>2010-07-12</date>
=20
 <section>
 <title>Portage Features</title>
@@ -132,10 +132,12 @@
 <body>
=20
 <p>
-<c>ccache</c> is a fast compiler cache. When you compile a program, it w=
ill=20
+<c>ccache</c> is a fast compiler cache. When you compile a program, it w=
ill
 cache intermediate results so that, whenever you recompile the same prog=
ram, the
-compilation time is greatly reduced. In common compilations this can res=
ult in 5
-to 10 times faster compilation times.
+compilation time is greatly reduced. The first time you run ccache, it w=
ill be
+much slower than a normal compilation. Subsequent recompiles should be f=
aster.
+ccache is only helpful if you will be recompiling the same application m=
any
+times; thus it's mostly only useful for software developers.
 </p>
=20
 <p>
@@ -143,6 +145,16 @@
 <uri link=3D"http://ccache.samba.org">ccache homepage</uri>.
 </p>
=20
+<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 pac=
kages
+that cannot be emerged. If this happens (if you receive errors like "Fil=
e not
+recognized: File truncated"), try recompiling the application with ccach=
e
+disabled (<c>FEATURES=3D"-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>