expand docs

[zpackage] / doc / zpm-merge.8

diff --git a/doc/zpm-merge.8 b/doc/zpm-merge.8
new file mode 100644 (file)
index 0000000..95da8ec
--- /dev/null
+++ b/doc/zpm-merge.8
@@ -0,0 +1,73 @@
+.TH zpm-merge 8 2019-02-14 "ZPM 0.6"
+.SH NAME
+zpm-merge \- copy packages from one database to another
+.SH SYNOPSIS
+.B zpm merge -f \fIpkgfile\fR
+[
+.B \-vFSauonO
+]
+[
+.BI \-d target
+]
+[
+.BI \-s status
+]
+.RI [ package ...]
+.SH DESCRIPTION
+\fBzpm-merge\fR copies package information from one database
+to another.  By default, file contents are not copied, but scripts
+are.  All other metadata about the package is copied, and the status
+is set to null.
+.SH OPTIONS
+.TP
+\-f \fIpath\fR
+specify the package file to find packages in, required
+.TP
+\-d \fIpath\fR
+specify the target database, defaults to $ZPMDB
+.TP
+\-s \fIstatus\fR
+set the status of the copied packages to \fIstatus\fR
+.TP
+\-v
+increase the verbosity level by one, may be given multiple times
+.B \-vFSauonO
+.TP
+\-F
+Also copy the file content.
+.TP
+\-S
+Do not copy script file content.
+.TP
+\-a
+Merge all packages.
+.TP
+\-u
+update
+.TP
+\-n
+newer
+.TP
+\-o
+older
+.TP
+\-O
+One at a time mode.  Each package will be copied in a single transaction,
+and failure of one package to copy will not prevent other packages from
+being copied.  Without this option, all the packages are copied in a
+single transaction so that either all are copied or none are.
+.SH EXAMPLES
+.TP
+zpm merge -f foo-1.0.3-1.zpm
+Merge the the most recent package found in the foo-1.0.3-1.zpm file
+into the local database specified by $ZPMDB.
+.SH EXIT STATUS
+0 on success non zero on failure
+.SH FILES
+/var/lib/zpm/local.db
+.SH ENVIRONMENT
+ZPMDB
+.SH AUTHOR
+Nathan Wagner
+.SH SEE ALSO
+zpm(8)