Bug #245779 - Document the new category subdirectory behavior for PKGDIR.

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

diff --git a/man/ebuild.1 b/man/ebuild.1
index 1384bb1576b4081df6c3ad037dcceb174927518c..52ab7b73598fc1aafcdf352a3c6ada462ad783de 100644 (file)
--- 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 3da39a620f59580dcd19b926221a1c7e87c9306c..e79dd1e08b2e910d74ad3e7d4148cf9b6668da1f 100644 (file)
--- 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 a8f93ca1cfc7e574b2b3078aaaaa313835297208..aa0875ed5649685cc454fc3214b4c3571953d5f4 100644 (file)
--- 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