Update the PORT_LOGDIR docs for bug #82378. Thanks to Arfrever FTA for reporting...
authorZac Medico <zmedico@gentoo.org>
Mon, 11 Jun 2007 21:26:23 +0000 (21:26 -0000)
committerZac Medico <zmedico@gentoo.org>
Mon, 11 Jun 2007 21:26:23 +0000 (21:26 -0000)
svn path=/main/branches/2.1.2/; revision=6811

cnf/make.conf
man/make.conf.5

index e8ac854e7d6aaff683d394a2b4f25749308a82a1..15d54da063ae6c4e39ac52518f2d6edcc11cb578 100644 (file)
 #PKGDIR=/usr/portage/packages
 #
 # PORT_LOGDIR is the location where portage will store all the logs it
-#     creates from each individual merge. They are stored as NNNN-$PF.log
-#     in the directory specified. This is disabled until you enable it by
-#     providing a directory. Permissions will be modified as needed IF the
-#     directory exists, otherwise logging will be disabled. NNNN is the
-#     increment at the time the log is created. Logs are thus sequential.
-#PORT_LOGDIR=/var/log/portage
+#     creates from each individual merge. They are stored as
+#     ${CATEGORY}:${PF}:YYYYMMDD-HHMMSS.log in the directory specified.
+#     If the direcory does not exist, it will be created automatically and
+#     group permissions will be applied to it.  If the directory already
+#     exists, portage will not modify it's permissions.
+#PORT_LOGDIR=""
 #
 # PORTDIR_OVERLAY is a directory where local ebuilds may be stored without
 #     concern that they will be deleted by rsync updates. Default is not
index 06fd1c48c67f0bd91be401afdcd34fdfefeb3750..5c211f92e447beb5d78d1b8433d84977b637dd03 100644 (file)
@@ -325,7 +325,11 @@ Defaults to /usr/portage/packages.
 .TP
 .B PORT_LOGDIR
 This variable defines the directory in which per\-ebuild logs are kept.
-Logs are created only when this is set and writable.
+Logs are created only when this is set. They are stored as
+${CATEGORY}:${PF}:YYYYMMDD\-HHMMSS.log in the directory specified. If the
+direcory does not exist, it will be created automatically and group permissions
+will be applied to it.  If the directory already exists, portage will not
+modify it's permissions.
 .TP
 \fBPORTAGE_BINHOST\fR = \fI"ftp://login:pass@grp.mirror.site/pub/grp/i686/athlon\-xp"\fR
 This is the host from which portage will grab prebuilt\-binary packages.