add HISTORY to various man pages

[plan9front.git] / sys / man / 1 / pkg

diff --git a/sys/man/1/pkg b/sys/man/1/pkg
index 3b5e3a84fd44a65f914e394a2e9a47fe43df2038..b5b1a750cdf61b143daa1d8e2796fc1337a0a69f 100644 (file)
--- a/sys/man/1/pkg
+++ b/sys/man/1/pkg
@@ -1,6 +1,6 @@
 .TH PKG 1
 .SH NAME
-create, install, list, local, remove \- trivial package management
+create, install, list, local, remove, unpkg \- trivial package management
 .SH SYNOPSIS
 .B pkg/create
 .I name
@@ -14,6 +14,8 @@ create, install, list, local, remove \- trivial package management
 .br
 .B pkg/remove
 .I name
+.br
+.B pkg/unpkg
 .SH DESCRIPTION
 .I Pkg 
 is a simple package management system primarily written in
@@ -33,16 +35,22 @@ Create builds a new package
 whose source is found in directory
 .IR name ,
 then packs it into a
-.IR bzip2 (1)
+.I bzip2 (see
+.IR gzip (1))
 compressed
-.IR tar(1)
+.IR tar (1)
 archive suitable for upload to a package
-repository.
+repository. The source directory should be provided as a full path.
 .TP
 .I Pkg/install 
 Install the package
 .I name
-from the current repository.
+from the current repository, unpacking the executables in
+.B /$cputype/bin/
+or
+.B /rc/bin/
+and the source in
+.B /sys/src/pkg/.
 .TP
 .I Pkg/list
 List packages available from the current repository.
@@ -54,29 +62,38 @@ List locally installed packages.
 Remove the package
 .I name
 from the local system.
+.TP
+.I Pkg/unpkg
+A modified
+.IR tar (1)
+used by
+.B pkg/install
+to generate checksums for every unpacked file.
 .SH EXAMPLES
 .LP
 Create the package
-.B links-variable-2011.05.23
+.B irc7-2012.06.22:
 .sp 1
 .EX
-% cd /sys/src
-% pkg/create links-variable-2011.05.23
+% pkg/create /sys/src/pkg/irc7-2012.06.22
 .EE
 
 .LP
 Install the
-.B Go
-programming language.
+.B gopherd
+server:
 .sp 1
 .EX
-% pkg/install go-2011.05.10
+% pkg/install gopherd-2012.04.15
 .EE
 .SH FILES
-.TF /sys/lib/pkg/*
+.TF
 .TP
 .B /sys/lib/pkg/*
 hash files of packages installed locally.
+.TP
+.B /sys/src/pkg/*
+source files of packages installed locally.
 .SH SOURCE
 .B /sys/src/cmd/pkg/create
 .br
@@ -89,5 +106,14 @@ hash files of packages installed locally.
 .B /sys/src/cmd/pkg/remove
 .br
 .B /sys/src/cmd/pkg/unpkg.c
+.SH REPOSITORIES
+.B http://r-36.net/9front/pkg/386
+.br
+.B http://plan9.bell-labs.com/sources/contrib/staal1978/pkg
 .SH SEE ALSO
-.IR contrib (1)
+.IR contrib (1) ,
+.IR gzip (1) ,
+.IR tar (1)
+.SH HISTORY
+.I Pkg
+first appeared in 9front (May, 2011).