man: document hg interface; update CVS host name

This commit is contained in:
Russ Cox 2007-11-04 20:30:18 -05:00
parent ea55a42c96
commit d944f76407
2 changed files with 124 additions and 5 deletions

View file

@ -4,11 +4,11 @@ cvs \- introduction using plan9port CVS repository
.SH SYNOPSIS
.B cvs
.B -d
.B :pserver:anoncvs@cvs.pdos.lcs.mit.edu:/cvs login
.B :pserver:anoncvs@cvs.pdos.csail.mit.edu:/cvs login
.PP
.B cvs
.B -d
.B :pserver:anoncvs@cvs.pdos.lcs.mit.edu:/cvs checkout plan9
.B :pserver:anoncvs@cvs.pdos.csail.mit.edu:/cvs checkout plan9
.PP
.B cvs
.B update
@ -43,12 +43,14 @@ cvs \- introduction using plan9port CVS repository
]
.PP
.B web
.B http://cvs.pdos.lcs.mit.edu/cvs/plan9/
.B http://cvs.pdos.csail.mit.edu/cvs/plan9/
.SH DESCRIPTION
The master source tree for Plan 9 from User Space is maintained
using the source control system CVS
as a poor substitute for Plan 9's
\fIreplica\fR(8) and dump file system.
(It is maintained simultaneously using Mercurial; see
.IR hg (1).)
.PP
The first argument to
.I cvs
@ -179,7 +181,7 @@ command first to create your
file.
.PP
The CVS tree can be inspected on the web at
.HR http://cvs.pdos.lcs.mit.edu/cvs/plan9/ "" .
.HR http://cvs.pdos.csail.mit.edu/cvs/plan9/ "" .
.SH EXAMPLES
Incorporate any changes made to the CVS tree since
the last check out or update:
@ -233,11 +235,13 @@ directory containing CVS metadata for parent
.B .cvsignore
list of files and wildcards to exclude from CVS operations in this directory
.SH SEE ALSO
.IR hg (1)
.PP
Unix's
\fIcvs\fR(1),
.HR http://www.cvshome.org/
.PP
.HR http://cvs.pdos.lcs.mit.edu/cvs/plan9/
.HR http://cvs.pdos.csail.mit.edu/cvs/plan9/
.SH BUGS
The CVS server is a read-only public copy of a private tree.
The dates on versions reflect the date the changes were made in the

115
man/man1/hg.1 Normal file
View file

@ -0,0 +1,115 @@
.TH HG 1
.SH NAME
hg \- introduction to using plan9port Mercurial repository
.SH SYNOPSIS
.B hg
.B clone
.B http://hg.pdos.csail.mit.edu/hg/plan9
.B plan9
.PP
.B hg
.B pull
.B -u
.PP
.B hg
.B diff
[
.B -r
.I revision
]
[
.I path ...
]
.PP
.B hg
.B serve
.PP
.B hg
.B view
.PP
.B web
.B http://hg.pdos.csail.mit.edu/hg/plan9/
.SH DESCRIPTION
The master source tree for Plan 9 from User Space is maintained
using the source control system Mercurial
as a substitute for Plan 9's
\fIreplica\fR(8) and dump file system.
(It is maintained simultaneously using CVS; see
.IR cvs (1).)
.PP
The first argument to
.I hg
is a command, which determines the form of the rest of the command line.
.PP
The
.B clone
command downloads a copy of the tree into the directory
.BR plan9 ,
which it will create.
After
.B hg
.BR clone ,
the other commands listed
should be run within the
.B plan9
directory tree.
.PP
Unlike CVS, Mercurial downloads the entire revision history
of Plan 9 from User Space
in addition to the current tree.
.PP
.I Hg
.I pull
incorporates changes from the master repository
into the local revision history.
The
.B -u
flag applies these changes to the current file tree.
.PP
.I Hg
.I diff
runs Unix's
.IR diff (1)
to compare the files in the local tree with the corresponding
files in the revision history.
By default it compares against the version that was most recently
incorporated into the local tree.
The
.B -r
flag specifies an alternate version to compare against.
The special revision
.B tip
refers to the most recent version on the server.
.PP
.I Hg
.I serve
starts an HTTP server serving information about
the local repository at the address
.BR http://localhost:8000/ .
.PP
.I Hg
.I view
starts an interactive history viewer.
.PP
The Mercurial tree can be inspected on the web at
.HR http://hg.pdos.csail.mit.edu/hg/plan9/ "" .
.SH FILES
.TP
.B \*9/.hg
directory containing Mercurial local repository
.TP
.B .hgignore
list of files and wildcards to exclude from Mercurial operations
.SH SEE ALSO
.IR cvs (1)
.PP
Unix's
\fIhg\fR(1),
.HR http://www.selenic.com/mercurial/wiki/
.PP
.HR http://hg.pdos.csail.mit.edu/hg/plan9/
.SH BUGS
The use of Mercurial for accessing Plan 9 from User Space
should be considered experimental.
People uncomfortable with Mercurial should continue to use
.IR cvs (1).