pkg: Added PKGLIST_LOCAL setting

With this, it is possibly to execute a local pkglist script.
This way, the package list can be retrieved by almost any possible means

1 files changed, 11 insertions, 0 deletions

diff --git a/man/7/pkg.pod b/man/7/pkg.pod
index 5c36bff..8288b54 100644
--- a/man/7/pkg.pod
+++ b/man/7/pkg.pod
@@ -63,6 +63,17 @@ repository type (DVCS), the third the current revision. Example:
 
   pkg git 82d716d01dee0329af7df5e67b55558fe3ff1466
 
+The package list is generated by the script set in the config var $PKGLIST_PATH,
+by default F<include/pkglist>.  Depending on $PKGLIST_LOCAL and $PKG_ROOT, it
+is either executed on the local host or on the remote host containing the package
+root.  The script is always called with $PKG_PATH as the first argument.
+Its output must only contain valid pkglist lines (see the example above).
+
+With $PKGLIST_LOCAL set to 1, there are some interesting possibilities.
+For instance, your pkglist script could contain a line like
+C<< curl -s http://example.org/cgi-bin/pkglist.cgi >> - so you can update your
+remote package list without having to use ssh.
+
 =head1 WHAT IS A PACKAGE?
 
 Anything tracked with git can be used as package. However, as the purpose of pkg