Support more than one package root

IMPORTANT: You'll need to update your pkglist script

2 files changed, 8 insertions, 6 deletions

diff --git a/man/5/caretaker.conf.pod b/man/5/caretaker.conf.pod
index 2fe9089..b1564b3 100644
--- a/man/5/caretaker.conf.pod
+++ b/man/5/caretaker.conf.pod
@@ -22,10 +22,11 @@ The text in [these braces] is the default value.
 
 =over
 
-=item B<PKG_ROOT>=I<url>   (--packageroot I<url>)
+=item B<PKG_ROOTS>=(I<url1> I<url2> I<...>)   (--packageroot I<url>)
 
-the package root path.
+the package root paths.
 I<url> may either be of the form C<ssh://host/path> or C</path>.
+At least one must be set.
 
 =item B<PKGLIST_PATH>=I<path>   [$PKG_PATH/pkglist]
 
diff --git a/man/7/caretaker.pod b/man/7/caretaker.pod
index 096c651..4601ff6 100644
--- a/man/7/caretaker.pod
+++ b/man/7/caretaker.pod
@@ -57,11 +57,12 @@ Also, the 'ct add' completion relies on .list-remote, and back in the days when
 caretaker supported more than one DVCS, it was used to determine which DVCS to use
 for which package.
 
-It consists of one line per package, each line containing three items separated
-by a single whitespace. The first item is the package name, the second one the
-repository type (DVCS), the third the current revision. Example:
+It consists of one line per package, each line containing three or four items separated
+by a single whitespace.  The first item is the package name, the second one the
+repository type (DVCS), the third the current revision; in the remote list, the fourth
+is the package root to which this package belongs.  Example:
 
-  caretaker git 82d716d01dee0329af7df5e67b55558fe3ff1466
+  caretaker git 82d716d01dee0329af7df5e67b55558fe3ff1466 git://git.tabularazor.org/~derf
 
 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