mirror of
https://github.com/9fans/plan9port.git
synced 2025-01-12 11:10:07 +00:00
116 lines
2.3 KiB
Groff
116 lines
2.3 KiB
Groff
|
.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).
|