summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorZac Medico <zmedico@gentoo.org>2008-11-19 03:14:48 +0000
committerZac Medico <zmedico@gentoo.org>2008-11-19 03:14:48 +0000
commitfaac6ea62ba56883fdeb82a7da418735504a5cdd (patch)
treebd0d9f5bb9296133fd1e938277003b1478af67c4 /man
parentMove the repo_name check/warning into a function. (diff)
downloadportage-idfetch-faac6ea62ba56883fdeb82a7da418735504a5cdd.tar.gz
portage-idfetch-faac6ea62ba56883fdeb82a7da418735504a5cdd.tar.bz2
portage-idfetch-faac6ea62ba56883fdeb82a7da418735504a5cdd.zip
Bug #245779 - Document the new category subdirectory behavior for PKGDIR.
svn path=/main/trunk/; revision=11997
Diffstat (limited to 'man')
-rw-r--r--man/ebuild.14
-rw-r--r--man/emerge.14
-rw-r--r--man/make.conf.58
3 files changed, 10 insertions, 6 deletions
diff --git a/man/ebuild.1 b/man/ebuild.1
index 1384bb15..52ab7b73 100644
--- a/man/ebuild.1
+++ b/man/ebuild.1
@@ -161,9 +161,7 @@ or other similar setups that the user may wish to run.
.BR package
This command is a lot like the \fImerge\fR command, except that after
fetching, unpacking, compiling and installing, a .tbz2 binary package
-tarball is created and stored in ${PKGDIR}/All (${PKGDIR} defaults to
-/usr/portage/packages). A symbolic link is created in
-${PKGDIR}/${CATEGORY} that points to the package in ${PKGDIR}/All.
+tarball is created and stored in \fBPKGDIR\fR (see \fBmake.conf\fR(5)).
.TP
.BR rpm
Builds a RedHat RPM package from the files in the temporary
diff --git a/man/emerge.1 b/man/emerge.1
index 3da39a62..e79dd1e0 100644
--- a/man/emerge.1
+++ b/man/emerge.1
@@ -246,8 +246,8 @@ Tells emerge to build binary packages for all ebuilds processed in
addition to actually merging the packages. Useful for maintainers
or if you administrate multiple Gentoo Linux systems (build once,
emerge tbz2s everywhere) as well as disaster recovery. The package
-will be created in the
-\fI${PKGDIR}/All\fR directory. An alternative for already\-merged
+will be created in the \fBPKGDIR\fR directory (see \fBmake.conf\fR(5)).
+An alternative for already\-merged
packages is to use \fBquickpkg\fR(1) which creates a tbz2 from the
live filesystem.
.TP
diff --git a/man/make.conf.5 b/man/make.conf.5
index a8f93ca1..aa0875ed 100644
--- a/man/make.conf.5
+++ b/man/make.conf.5
@@ -401,7 +401,13 @@ 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. Note
+Defines the location where created .tbz2 binary packages will be
+stored when the \fBemerge\fR(1) \fB\-\-buildpkg\fR option is enabled.
+By default, a given package is stored in a subdirectory corresponding
+to it's category. However, for backward compatibility with the layout
+used by older versions of portage, if the \fI${PKGDIR}/All\fR directory
+exists then all packages will be stored inside of it and symlinks to
+the packages will be created in the category subdirectories. Note
that locations under /usr/portage are not necessarily safe for data storage.
See the \fBPORTDIR\fR documentation for more information.
.br