From c6ad8e0bc8c347383fdce8f5d120f613bfbe07d2 Mon Sep 17 00:00:00 2001 From: Sebastian Luther Date: Tue, 13 Jul 2010 07:48:00 -0700 Subject: [PATCH] Bug #328099 - Adjust ccache documentation --- man/make.conf.5 | 8 ++++++-- 1 file 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. -- 2.26.2