From: Sebastian Luther Date: Tue, 13 Jul 2010 14:48:00 +0000 (-0700) Subject: Bug #328099 - Adjust ccache documentation X-Git-Tag: v2.2_rc68~509 X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=c6ad8e0bc8c347383fdce8f5d120f613bfbe07d2;p=portage.git Bug #328099 - Adjust ccache documentation --- 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.