From 1db07c1b6aeb15056a27be26651b31b4a7f8d45f Mon Sep 17 00:00:00 2001 From: Nathan Wagner Date: Tue, 11 Dec 2018 15:42:41 +0000 Subject: [PATCH] add repo and vercmp man pages --- Makefile | 2 +- doc/zpm-repo.8 | 33 +++++++++++++++++++++++++++++++++ doc/zpm-vercmp.8 | 33 +++++++++++++++++++++++++++++++++ 3 files changed, 67 insertions(+), 1 deletion(-) create mode 100644 doc/zpm-repo.8 create mode 100644 doc/zpm-vercmp.8 diff --git a/Makefile b/Makefile index dd84d52..8e4b942 100644 --- a/Makefile +++ b/Makefile @@ -34,7 +34,7 @@ ZPKGBIN=zpm-addfile zpm-extract zpm-init zpm-vercmp zpm-stat zpm-hash \ SCRIPTS=zpm zpm-install zpm-merge zpm-list zpm-preserve zpm-test zpm-log \ zpm-contents zpm-uninstall zpm-pathmod zpm-rmpackage zpm-newpackage \ zpm-pkg zpm-add zpm-pkgfile zpm-gc zpm-repo zpm-update zpm-confgit -MANPAGES=doc/zpm.8 $(addprefix doc/zpm-, list.8 contents.8 hash.8 quote.8 pathmod.8 note.8) +MANPAGES=doc/zpm.8 $(addprefix doc/zpm-, list.8 contents.8 hash.8 quote.8 pathmod.8 note.8 vercmp.8 repo.8) COMPILED=$(ZPKGBIN) PROGRAMS=$(SCRIPTS) $(COMPILED) diff --git a/doc/zpm-repo.8 b/doc/zpm-repo.8 new file mode 100644 index 0000000..4cdb964 --- /dev/null +++ b/doc/zpm-repo.8 @@ -0,0 +1,33 @@ +.TH zpm-contents 8 2018-11-30 "ZPM 0.2" +.SH NAME +zpm-contents \- list files in a zpm package +.SH SYNOPSIS +.B zpm contents +[ +.BI -f " pkgfile" +] +[ +.I package ... +] +[ +.B -- +.I fileglob ... +] +.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. +.SH OPTIONS +\-f specify the package file to find packages in +.SH EXAMPLES +zpm contents +.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) diff --git a/doc/zpm-vercmp.8 b/doc/zpm-vercmp.8 new file mode 100644 index 0000000..9a31fac --- /dev/null +++ b/doc/zpm-vercmp.8 @@ -0,0 +1,33 @@ +.TH zpm-vercmp 8 2018-12-10 "ZPM 0.4" +.SH NAME +zpm-vercmp \- compare strings with version numbering +.SH SYNOPSIS +.B zpm vercmp \fR[\fB-q\fR] \fIstring1 string2\fR +.SH DESCRIPTION +\fBzpm-vercmp\fR compares its first two arguments, using +the usual version numbering semantics. It will write +the result of the comparison to stdout, 0 if the arguments +compare equal, -1 if the first is greater, and 1 if the +second is greater. +.SH OPTIONS +.TP +\-q +write nothing to stdout. The program will still exit with the +usual exit status +.SH EXAMPLES +.PP +.nf +zpm-vercmp a b -> "1" +.fi +.SH EXIT STATUS +0 if the two strings compare equal +-1 if the first string is greater than the second +1 if the second string is greater then the first +.SH FILES +None +.SH ENVIRONMENT +None +.SH AUTHOR +Nathan Wagner +.SH SEE ALSO +zpm(8) -- 2.40.0