From: Zac Medico <zmedico@gentoo.org>
Date: Mon, 11 Jun 2007 21:26:23 +0000 (-0000)
Subject: Update the PORT_LOGDIR docs for bug #82378.  Thanks to Arfrever FTA for reporting... 
X-Git-Tag: v2.1.3_rc1~15
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=629b653237f61fbef8b9e0e9f287c49da32a815f;p=portage.git

Update the PORT_LOGDIR docs for bug #82378.  Thanks to Arfrever FTA for reporting. (trunk r6810)

svn path=/main/branches/2.1.2/; revision=6811
---

diff --git a/cnf/make.conf b/cnf/make.conf
index e8ac854e7..15d54da06 100644
--- a/cnf/make.conf
+++ b/cnf/make.conf
@@ -93,12 +93,12 @@
 #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
diff --git a/man/make.conf.5 b/man/make.conf.5
index 06fd1c48c..5c211f92e 100644
--- a/man/make.conf.5
+++ b/man/make.conf.5
@@ -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.