expand docs

[zpackage] / doc / zpm-repo.8

diff --git a/doc/zpm-repo.8 b/doc/zpm-repo.8
index 4cdb964771f2e8f221338dcca8c5211d027a8193..2d5ac0f8395ac17d71188e5391413831733a9df9 100644 (file)
--- a/doc/zpm-repo.8
+++ b/doc/zpm-repo.8
@@ -1,26 +1,71 @@
-.TH zpm-contents 8 2018-11-30 "ZPM 0.2"
+.TH zpm-repo 8 2018-11-30 "ZPM 0.2"
 .SH NAME
-zpm-contents \- list files in a zpm package
+zpm-repo \- manage remote package repositories
 .SH SYNOPSIS
-.B zpm contents
+.B zpm repo
 [
-.BI -f " pkgfile"
+.BI -R " path"
 ]
 [
-.I package ...
+.BI -d " path"
 ]
 [
-.B --
-.I fileglob ...
+.I subcommand ...
 ]
 .SH DESCRIPTION
-zpm-contents lists files belonging to any of the given packages,
-or all packages.  Additionally, the list of packages can be
-terminated with '--' and any additional arguments are glob patterns.
+zpm-repo manages remote repositories
+.PP
+zpm-repo operates in several modes: list, add, del(ete), url,
+.SS list
+lists each defined remote repository, along with its priority, url,
+and a unix timestamp of the last time it was refreshed.
+.SS add
+zpm-repo add \fIname url\fR
+.PP
+add a new repository.  The name is arbitrary.
+.SS del
+zpm-repo del \fIname\fR
+.PP
+Delete the named repository.  Also delete any cached packages downloaded
+from this repository.
+.SS url
+zpm-repo url \fIname [ newurl ]\fR
+.PP
+Print or set the url of a given repository.
+.SS pri
+zpm-repo pri \fIname [ newurl ]\fR
+.PP
+Print or set the priority of a given repository.
+.SS fetch
+zpm-repo fetch \fIname downloadargs\fR
+.PP
+download a given package, download is an alias for fetch.
+.SS update
+zpm-repo update \fIname\fR
+.PP
+Update repository metadata.  Pull is an alias for update.
+.SS packages
+zpm-repo packages \fIname\fR
+.PP
+List packages contained in a repo.
+.SS contents
+zpm-repo contents \fIname package\fR
+.PP
+List files contained in a given package of a repo.
+.SS purge
+zpm-repo purge \fIname purgeinfo\fR
+.PP
+Deletes packages from the repository package cache.  Deletes
+all packages if purgeinfo is not given.
 .SH OPTIONS
-\-f specify the package file to find packages in
+.TP
+\-R
+specify a root directory for packages
+.TP
+\-d
+specify a zpm database where repository information is stored.
 .SH EXAMPLES
-zpm contents 
+zpm repo 
 .SH EXIT STATUS
 0 on success non zero on failure
 .SH FILES
@@ -30,4 +75,5 @@ ZPMDB
 .SH AUTHOR
 Nathan Wagner
 .SH SEE ALSO
-zpm(8)
+.BR zpm (8)
+.BR zpm-fetchurl (8)