1 files changed, 234 insertions, 0 deletions
diff --git a/doc/pkg-get.8 b/doc/pkg-get.8
new file mode 100644
index 0000000..1ec46a0
--- /dev/null
+++ b/doc/pkg-get.8
@@ -0,0 +1,234 @@
+." Text automatically generated by txt2man-1.4.7
+.TH pkg-get 8 "April 23, 2006" "" ""
+.SH NAME
+\fBpkg-get \fP- a package management tool for CRUX Linux
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBpkg-get\fP \fIcommand\fP <arguments> [\fIoptions\fP] 
+.fam T
+.fi
+.SH DESCRIPTION
+\fBpkg-get\fP is a simple package management tool for CRUX Linux.
+It tries to replicate some of the most useful features of the
+port management tool \fBprt-get\fP(8) to be used with binary packages.
+\fBpkg-get\fP requires a remote or local package repository that
+can be generated by repository maintainers with the
+\fBpkg-repgen\fP(8) script.
+.SH COMMANDS
+.TP
+.B
+install <package1> [<package2>..<packageN>]
+Install given packages,
+download if necessary.
+.TP
+.B
+update <package1> [<package2>..<packageN>]
+Update given packages,
+download if necessary.
+.TP
+.B
+diff
+Show a list of outdated packages.
+.TP
+.B
+quickdiff
+Show a compact list of outdated packages.
+.TP
+.B
+sysup
+Update all outdated packages. Download if necessary.
+.TP
+.B
+depinst <package1> [<package2>..<packageN>]
+Install given packages
+and relative dependencies.
+.TP
+.B
+depends <package>
+Show a recursive list of dependencies for package
+and their installation status.
+.TP
+.B
+dependent <package> [\fB--all\fP]
+Show installed (or all with the \fB--all\fP option) packages
+that depend from package.
+.TP
+.B
+quickdep <package>
+Show a brief list of dependencies for package.
+.TP
+.B
+info <package>
+Show information about package.
+.TP
+.B
+current <package>
+Show currently installed version of package.
+.TP
+.B
+path <package>
+Show local path of package.
+.TP
+.B
+readme <package>
+Print README information (if available) for the package.
+.TP
+.B
+list
+List all packages in the repository.
+.TP
+.B
+listinst
+List all installed packages.
+.TP
+.B
+isinst <package>
+Display whether a package is installed.
+.TP
+.B
+dsearch <string>
+Search for packages which name or description contain <string>.
+.TP
+.B
+search <string>
+Search for packages which name contains <string>.
+.TP
+.B
+dup
+List all duplicates ports (present in more than one repository).
+.TP
+.B
+printf <format string1> [\fB--filter\fP=<filter>]
+Description blatantly
+stolen from prt-get man file. Print formatted port list. Format string can
+contain variables, which are replaced like this:
+.RS
+.IP \(bu 3
+%n -> name
+.IP \(bu 3
+%p -> path
+.IP \(bu 3
+%v -> version
+.IP \(bu 3
+%r -> release
+.IP \(bu 3
+%d -> description
+.IP \(bu 3
+%e -> dependencies
+.IP \(bu 3
+%u -> url
+.IP \(bu 3
+%R -> Readme ("yes"/"no")
+.IP \(bu 3
+%E -> pre-install script ("yes"/"no")
+.IP \(bu 3
+%O -> post-install script ("yes"/"no")
+.IP \(bu 3
+%M -> "Nobody". for compatibility with prt-get
+.IP \(bu 3
+%P -> "Nobody". for compatibility with prt-get
+.IP \(bu 3
+%l -> is locked ("yes"/"no")
+.IP \(bu 3
+%i -> "no" if not installed, "yes" if it's installed and up to
+date and "diff" if it's installed and a new version is in the
+repository.
+.RE
+.PP
+Use "\\n" and "\\t" to format your output (no additional format
+specified suported). The optional format string2 can contain the
+same variables as format string1 and is used to sort the output.
+You can specify a wildcard filter to filter by package name.
+.TP
+.B
+lock <package1> [<package2>..<packageN>]
+Lock a package (ignore updates).
+.TP
+.B
+unlock <package1> [<package2>..<packageN>]
+Unlock a package.
+.TP
+.B
+listlocked
+Display a list of locked packages.
+.TP
+.B
+sync
+Syncronize local packages with the ones from the remote repository.
+If the repository is local, this \fIcommand\fP does nothing.
+.TP
+.B
+sysup
+Update all outdated packages.
+.TP
+.B
+help
+Display  brief help screen.
+.TP
+.B
+version
+Show \fBpkg-get\fP version.
+.SH OPTIONS
+.TP
+.B
+\fB-r\fP <root>
+Use <root> directory when wrapping pkgadd. Note that
+this only works with update / install !
+.TP
+.B
+\fB-do\fP
+Download only. Applicable to: sysup, depinst, install, update.
+.TP
+.B
+\fB-f\fP
+Force installing / upgrading. This is passed to \fBpkgadd\fP(8).
+.TP
+.B
+\fB-im\fP
+Ignore md5sum mismatches.
+.TP
+.B
+\fB--aargs\fP="arguments"
+pass the specified arguments to \fBpkgadd\fP(8).
+.TP
+.B
+\fB--config\fP=/path/to/file
+Use the specified configuration file.
+.TP
+.B
+\fB--pre-install\fP
+executes pre-install script if available.
+.TP
+.B
+\fB--post-install\fP
+executes post-install script if available.
+.TP
+.B
+\fB--install-scripts\fP
+executes pre-install and post-install
+scripts if available.
+.RE
+.PP
+
+.SH CONFIGURATION
+Configuration is handled by the /etc/pkg-get.conf file,
+\fIoptions\fP are explained in the file itself.
+.SH EXAMPLES
+.TP
+.B
+\fBpkg-get\fP install sqlite pysqlite
+Install sqlite and pysqlite.
+.TP
+.B
+\fBpkg-get\fP depinst kdebase \fB-f\fP
+Install kdebase and all its dependencies, forcing upgrade.
+.TP
+.B
+\fBpkg-get\fP sysup \fB-do\fP
+Download new releases of all the outdated packages.
+.SH AUTHORS
+Simone Rota <sip@varlock.com>
+.SH SEE ALSO
+\fBpkgadd\fP(8), \fBprt-get\fP(8)