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
Date: Tue, 13 Jul 2010 00:26:59 +0000 (UTC) [thread overview]
Message-ID: <20100713002659.847B42CE14@corvid.gentoo.org> (raw)
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>
next reply other threads:[~2010-07-13 0:27 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2010-07-13 0:26 Joshua Saddler (nightmorph) [this message]
-- strict thread matches above, loose matches on Subject: below --
2011-10-27 18:33 [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-working-features.xml Sven Vermeulen (swift)
2011-11-27 18:25 Sven Vermeulen (swift)
2012-03-28 22:44 Joshua Saddler (nightmorph)
2013-12-17 11:05 Sven Vermeulen (swift)
2013-12-17 11:34 Sven Vermeulen (swift)
2013-12-17 11:35 Sven Vermeulen (swift)
2014-04-12 12:33 Sven Vermeulen (swift)
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20100713002659.847B42CE14@corvid.gentoo.org \
--to=nightmorph@gentoo.org \
--cc=docs-team@lists.gentoo.org \
--cc=gentoo-doc-cvs@lists.gentoo.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox