summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSebastian Luther <SebastianLuther@gmx.de>2010-07-13 07:48:00 -0700
committerZac Medico <zmedico@gentoo.org>2010-07-13 07:57:13 -0700
commitc6ad8e0bc8c347383fdce8f5d120f613bfbe07d2 (patch)
treec2b1b2591c71bef27ed9161384820e9b2795e9ce
parente8cc36816634b0bfb22142941dbf579960343c99 (diff)
downloadportage-c6ad8e0bc8c347383fdce8f5d120f613bfbe07d2.tar.gz
portage-c6ad8e0bc8c347383fdce8f5d120f613bfbe07d2.tar.bz2
portage-c6ad8e0bc8c347383fdce8f5d120f613bfbe07d2.zip
Bug #328099 - Adjust ccache documentation
-rw-r--r--man/make.conf.58
1 files changed, 6 insertions, 2 deletions
diff --git a/man/make.conf.5 b/man/make.conf.5
index 236cbeeb7..161fda337 100644
--- a/man/make.conf.5
+++ b/man/make.conf.5
@@ -216,8 +216,12 @@ Enable portage support for the ccache package. If the ccache dir is not
present in the user's environment, then portage will default to
${PORTAGE_TMPDIR}/ccache.
-\fBWarning\fR: This feature is known to cause compilation
-failure and is not recommended for general use.
+\fBWarning\fR: This feature 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 before reporting a bug. Unless you are doing development
+work, do not enable ccache.
.TP
.B collision\-protect
A QA\-feature to ensure that a package doesn't overwrite files it doesn't own.