Add a note that PORTDIR is a repository of software and that users should not add...

svn path=/main/trunk/; revision=9209

diff --git a/man/make.conf.5 b/man/make.conf.5
index 42182a826706c9c8e12d2a63644cebeb80e014f7..e02bcd9eba9fa461849198ca41200b77a18e19c3 100644 (file)
--- a/man/make.conf.5
+++ b/man/make.conf.5
@@ -456,7 +456,9 @@ Data stored inside \fBPORTDIR\fR is in peril of being overwritten or deleted by
 the emerge \-\-sync command. The default value of
 \fBPORTAGE_RSYNC_OPTS\fR will protect the default locations of
 \fBDISTDIR\fR and \fBPKGDIR\fR, but users are warned that any other locations
-inside \fBPORTDIR\fR are not necessarily safe for data storage.
+inside \fBPORTDIR\fR are not necessarily safe for data storage.  You should not 
+put other data (such as overlays) in your \fBPORTDIR\fB.  Portage will walk 
+directory structures and may arbitrary add invalid categories as packages.
 .TP
 \fBPORTDIR_OVERLAY\fR = \fI"[path] [different\-path] [etc...]"\fR
 Defines the directories in which user made ebuilds may be stored and not