merge

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

diff --git a/sys/man/1/pkg b/sys/man/1/pkg
index 9e75a92bc11c59c86fd2961b9027ab5f3f94d5f4..269dfa672719124c8b1b1b8edc863d1bd99acd1e 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
@@ -30,17 +32,25 @@ packages.
 .I Pkg/create 
 Create builds a new package
 .IR name ,
+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.
@@ -52,20 +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 irc7-2012.06.22:
+.sp 1
+.EX
+% pkg/create /sys/src/pkg/irc7-2012.06.22
+.EE
+
 .LP
 Install the
-.B Go
-programming language.
+.B mpm
+troff macros:
 .sp 1
 .EX
-% pkg/install go-2011.05.10
+% pkg/install mpm-2011.05.14
 .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
@@ -78,5 +106,17 @@ hash files of packages installed locally.
 .B /sys/src/cmd/pkg/remove
 .br
 .B /sys/src/cmd/pkg/unpkg.c
+.SH REPOSITORIES
+.B http://9front.org/pkg/386
+.br
+.B https://offblast.org/pkg/386
+.br
+.B https://offblast.org/pkg/amd64
+.br
+.B http://plan9.bell-labs.com/sources/contrib/staal1978/pkg
 .SH SEE ALSO
-.IR contrib (1)
+.IR gzip (1) ,
+.IR tar (1)
+.SH HISTORY
+.I Pkg
+first appeared in 9front (May, 2011).