diff options
| author |   Zac Medico <zmedico@gentoo.org> | 2007-07-01 17:08:59 +0000 |
|---|---|---|
| committer | Zac Medico <zmedico@gentoo.org> | 2007-07-01 17:08:59 +0000 |
| commit | d6faec0c56f6aa65c287900daf9b56e5dba99e9f (patch) | |
| tree | 6293e9e84fe55dbedc2f9b53b3cb6f0d806733f5 /man/make.conf.5 | |
| parent | Revert --buildpkgonly logic back because it was already correct. (diff) | |
| download | portage-idfetch-d6faec0c56f6aa65c287900daf9b56e5dba99e9f.tar.gz portage-idfetch-d6faec0c56f6aa65c287900daf9b56e5dba99e9f.tar.bz2 portage-idfetch-d6faec0c56f6aa65c287900daf9b56e5dba99e9f.zip | |
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.
svn path=/main/trunk/; revision=7112
Diffstat (limited to 'man/make.conf.5')
| -rw-r--r-- | man/make.conf.5 | 23 |
1 files changed, 14 insertions, 9 deletions
diff --git a/man/make.conf.5 b/man/make.conf.5 index d0de72fd..e0c0bbbf 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 @@ -325,7 +327,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 @@ -420,18 +424,19 @@ Defaults to /var/tmp. This variable controls permissions for \fIWORKDIR\fR (see \fBebuild\fR(5)). .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 |