[pkgsrc/trunk]: pkgsrc/pkgtools/pbulk/files/pbulk Added some comments to the ...

[rillig <rillig%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/fbad64a3a4c1
branches:  trunk
changeset: 532597:fbad64a3a4c1
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Fri Aug 24 06:32:41 2007 +0000

description:
Added some comments to the configuration file, to help the uninitiated
reader.

diffstat:

 pkgtools/pbulk/files/pbulk/pbulk.conf |  23 +++++++++++++++++++++--
 1 files changed, 21 insertions(+), 2 deletions(-)

diffs (59 lines):

diff -r ed86fd1f438e -r fbad64a3a4c1 pkgtools/pbulk/files/pbulk/pbulk.conf
--- a/pkgtools/pbulk/files/pbulk/pbulk.conf     Fri Aug 24 03:30:54 2007 +0000
+++ b/pkgtools/pbulk/files/pbulk/pbulk.conf     Fri Aug 24 06:32:41 2007 +0000
@@ -1,7 +1,14 @@
-# $NetBSD: pbulk.conf,v 1.6 2007/08/15 21:10:55 joerg Exp $
+# $NetBSD: pbulk.conf,v 1.7 2007/08/24 06:32:41 rillig Exp $
 
+# The URL where the build report will be made available. This is only
+# used in the .txt version of the report.
+#
 base_url=http://www.pkgsrc-box.org/reports/current/DragonFly-1.8
-# On a single-processor, non-distributed build, you may want to say "no" here.
+
+# The pbulk framework can use multiple machines to build the packages.
+# On a single-processor, non-distributed build, you may want to say "no"
+# here.
+#
 master_mode=yes
 
 master_ip=192.168.75.10
@@ -11,19 +18,28 @@
 master_port_scan=${master_ip}:2001
 master_port_build=${master_ip}:2002
 
+# Some flags for the programs that publish the binary packages and the
+# build report. If you want to disable the publishing at all, see below.
+#
 pkg_rsync_args="-av --delete-excluded -e ssh"
 pkg_rsync_target="pkgsrc@192.168.75.1:/public/packages/current/DragonFly-1.8"
 report_rsync_args="-av --delete-excluded -e ssh"
 report_rsync_target="pkgsrc@192.168.75.1:/public/reports/current/DragonFly-1.8"
 report_subject_prefix="pkgsrc"
 report_recipient="pkgsrc-bulk%netbsd.org@localhost"
+
+# An archive containing the pkgsrc binary tree after bootstrapping.
+#
 bootstrapkit=/usr/pkgsrc/bootstrap/bootstrap.tar.gz
+
 # Optionally build a subset of the available packages and their dependencies.
 # The file is a newline separated list of package locations (e.g. lang/perl5).
 #limited_list=/limited_list
 
 report_graph_script_limit=512
 
+# The directories where the various files are created.
+#
 bulklog=/bulklog
 packages=/packages
 prefix=/usr/pkg
@@ -42,6 +58,9 @@
 pkg_add=${pkg_install_prefix}/sbin/pkg_add
 pkg_delete=${pkg_install_prefix}/sbin/pkg_delete
 
+# The tools that are used for building the packages. If you do not want
+# to publish anything at all, set rsync=: and mail=:.
+#
 bzip2=@BZIP2@
 digest=@DIGEST@
 gzip="@GZIP_CMD@"