From 3f8f69708248017f49a304ab8d1f57f26a4ccf7e Mon Sep 17 00:00:00 2001
From: Daniel Friesel <derf@derf.homelinux.org>
Date: Sat, 11 Oct 2008 11:41:51 +0200
Subject: Automatically update on upgrade/push

---
 man/1/pkg      |  6 ++++--
 man/5/pkg.conf | 25 ++++++++++++++++---------
 2 files changed, 20 insertions(+), 11 deletions(-)

(limited to 'man')

diff --git a/man/1/pkg b/man/1/pkg
index f96b6f7..7733692 100644
--- a/man/1/pkg
+++ b/man/1/pkg
@@ -102,11 +102,13 @@ Please refer to pkg(7)
 
 =item * B<pkg remote-update; pkg upgrade>
 
-Get new stuff from the packages_root
+Get new stuff from the packages_root.
+Note: If you haven't disabled AUTOUPDATE, B<pkg upgrade> will suffice here
 
 =item * B<pkg local-update; pkg push>
 
-Push local changes to the packages_root
+Push local changes to the packages_root.
+Note: If you haven't disabled AUTOUPDATE, B<pkg push> will suffice here
 
 =item * B<pkg refresh core>
 
diff --git a/man/5/pkg.conf b/man/5/pkg.conf
index 78d9df0..4b04166 100644
--- a/man/5/pkg.conf
+++ b/man/5/pkg.conf
@@ -13,26 +13,33 @@ The file consists of multiple lines of the form I<variable>=I<value>.
 Normal zsh syntax is allowed, which means everything after '#' will be treated
 a comment and that there must be no space between the variable and the content.
 
+With the exception of B<PKG_ROOT>, all variables are optional as they have
+reasonable (so I hope) defaults.
+
 =head1 OPTIONS
 
 =over
 
 =item B<PKG_ROOT>=I<url>
 
-the package root path.
-Default: ssh://derf.homelinux.org/~/var/packages_root
+the package root path
+
+=item B<PDIR>=I<path> ($HOME/packages)
+
+path for the local package tree
+
+=item B<CL_OPTIONS>=I<options> (-q)
 
-=item B<PDIR>=I<path>
+Options to invoke L<checklinks>(1) with
 
-path for the local package tree.
-Default: $HOME/packages
+=item B<SILENT>=I<boolean> (0)
 
-WARNING: changing this will break everything. Don't do it.
+Operate in silent mode if 1
 
-=item B<CL_OPTIONS>=I<options>
+=item B<AUTOUPDATE>=I<boolean> (1)
 
-Options to invoke L<checklinks>(1) with.
-Default: -q
+If 1, automatically execute 'pkg update' before 'pkg push'
+and 'pkg remote-update' before 'pkg upgrade'
 
 =back
 
-- 
cgit v1.2.3