From 4c98aea0c2753d842e73f3b3f350ee40f638d02c Mon Sep 17 00:00:00 2001 From: Zac Medico Date: Sun, 1 Jul 2007 17:10:04 +0000 Subject: For bug #131030, update the warning about potential for emerge --sync overwrite or delete files in ${PORTDIR}. Add references to the PKGDIR and DISTDIR docs. (trunk r7112) svn path=/main/branches/2.1.2/; revision=7113 --- man/make.conf.5 | 23 ++++++++++++++--------- 1 file changed, 14 insertions(+), 9 deletions(-) (limited to 'man/make.conf.5') diff --git a/man/make.conf.5 b/man/make.conf.5 index 5af718690..bbad0dd4d 100644 --- a/man/make.conf.5 +++ b/man/make.conf.5 @@ -96,7 +96,9 @@ This variable is passed by the \fIebuild scripts\fR to the \fIconfigure\fR as \fI\-\-target=${CTARGET}\fR only if it is defined. .TP \fBDISTDIR\fR = \fI[path]\fR -Defines the location of your local source file repository. +Defines the location of your local source file repository. Note +that locations under /usr/portage are not necessarily safe for data storage. +See the \fBPORTDIR\fR documentation for more information. .br Defaults to /usr/portage/distfiles. .TP @@ -322,7 +324,9 @@ Defines if color should be disabled by default. Defaults to false. .TP \fBPKGDIR\fR = \fI[path]\fR -Defines the location where created .tbz2 binary packages will be stored. +Defines the location where created .tbz2 binary packages will be stored. Note +that locations under /usr/portage are not necessarily safe for data storage. +See the \fBPORTDIR\fR documentation for more information. .br Defaults to /usr/portage/packages. .TP @@ -401,18 +405,19 @@ Defines the location of the temporary build directories. Defaults to /var/tmp. .TP \fBPORTDIR\fR = \fI[path]\fR -Defines the location of your Portage tree. +Defines the location of the Portage tree. This is the repository for all +profile information as well as all ebuilds. If you change this, you must update +your /etc/make.profile symlink accordingly. .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. +Data stored inside \fBPORTDIR\fR is in peril of being overwritten or deleted by +the emerge \-\-sync command. The default value of +\fBPORTAGE_EXTRA_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. .TP \fBPORTDIR_OVERLAY\fR = \fI"[path] [different\-path] [etc...]"\fR Defines the directories in which user made ebuilds may be stored and not -- cgit v1.2.3-1-g7c22