# HG changeset patch
# User John Floren <john@jfloren.net>
# Date 1316644604 25200
# Node ID cef5b548c6a057449d1da084f9a6271fcd181d84
# Parent  fd2dce961f23395f459ad8d78340c90ff1898241
pm: updated for current changes. Please work, I've already typed this 6 times... codereview is not good with authenticating through proxies I think.

R=nix-dev, rminnich
CC=nix-dev
http://codereview.appspot.com/5086046

diff -r fd2dce961f23 -r cef5b548c6a0 sys/man/1/pm
--- a/sys/man/1/pm	Wed Sep 21 18:58:41 2011 +0000
+++ b/sys/man/1/pm	Wed Sep 21 15:36:44 2011 -0700
@@ -1,6 +1,6 @@
 .TH PM 1
 .SH NAME
-install, list, pull, clean, depclean, remove \- package management scripts
+install, list, pull, remove \- package management scripts
 .SH SYNOPSIS
 .B pm/install
 [
@@ -21,13 +21,7 @@
 .B pm/pull
 .I category/name
 .br
-.B pm/clean
-.I category/name
-.br
-.B pm/depclean
-.I category/name
-.br
-.B contrib/remove
+.B pm/remove
 .I category/name
 .SH DESCRIPTION
 .I PM 
@@ -37,13 +31,7 @@
 .IR 9pm ,
 but with greater focus on speed and maintainability. Packages are stored as
 .B .tgz
-files on an HTTP server, rather than as discrete files on sources, for improved speed. Packages do not install sources to
-.B /sys/src;
-rather, sources are placed in 
-.B /contrib/src,
-to keep the
-.B /sys/src
-tree clean.
+files on an HTTP server, rather than as discrete files on sources, for improved speed.
 .PP
 Packages are described by a category and a name. Categories include 
 .I devel,
@@ -56,7 +44,7 @@
 and
 .I openssh.
 A full accounting of categories may be obtained by simply listing the directories in
-.IR /contrib/packages/ .
+.B /contrib/packages/ .
 Listing of individual packages is accomplished through the
 .B pm/list
 command.
@@ -80,6 +68,24 @@
 .TP
 .I pm/remove
 Deletes files installed by the specified package. Does not remove dependency packages, as they may be needed by other packages.
+.SH PACKAGE SERVERS
+Any HTTP server may act as a package server provided its HTTP root directory contains a 
+.B contrib/packages
+directory with 
+.B root.tgz
+files in the package directories. The list of package servers is maintained in 
+.B /lib/ndb/local
+in the following format:
+.br
+.EX
+	pm=srvlist
+		srv=jfloren.net
+		srv=anotherserver.com
+.EE
+.br
+Additional servers may be added; servers will be tried in order. If a package is not found on one server, the other servers will be tried one after the other until a 
+.B root.tgz
+file is found.
 .SH EXAMPLES
 .LP
 Install Mercurial.
@@ -103,6 +109,9 @@
 .TP
 .B /contrib/packages/*/*
 directories for individual packages.
+.TP
+.B /lib/ndb/local
+HTTP servers with packages for downloading.
 .SH SOURCE
 .B /rc/bin/pm
 .SH SEE ALSO