summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
Diffstat (limited to 'man')
-rw-r--r--man/1/pkg6
-rw-r--r--man/5/pkg.conf25
2 files changed, 20 insertions, 11 deletions
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