From: Alec Warner <antarus@gentoo.org>
Date: Thu, 1 Feb 2007 20:13:39 +0000 (-0000)
Subject: add warning about storing data in PORTDIR
X-Git-Tag: v2.2_pre1~1765
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=63028c3860101e4272b9e78cdd47f2c2eabe1b32;p=portage.git

add warning about storing data in PORTDIR

svn path=/main/trunk/; revision=5866
---

diff --git a/man/make.conf.5 b/man/make.conf.5
index 6956be9b1..f5700cf54 100644
--- a/man/make.conf.5
+++ b/man/make.conf.5
@@ -381,6 +381,15 @@ Defaults to /var/tmp.
 Defines the location of your Portage tree.
 .br
 Defaults to /usr/portage. 
+.br
+\fB***Warning***\fR
+.br
+Storing data such as distfiles and binary packages in PORTDIR can
+be potentially dangerous. The default emerge configuration defaults to this 
+behavior (which will work fine), however if you deviate from the default
+configuration by changing PKGDIR or DISTDIR, emerge \-\-sync may inadvertedly
+delete all your distfiles/binary packages. Please make sure to set
+\fBPORTAGE_EXTRA_RSYNC_OPTS\fR properly to insure the safety of files in PORTDIR.
 .TP
 \fBPORTDIR_OVERLAY\fR = \fI"[path] [different\-path] [etc...]"\fR
 Defines the directories in which user made ebuilds may be stored and not