1 .TH HG 1
2 .SH NAME 
3 hg, cvs \- introduction to using plan9port Mercurial repository
4 .SH SYNOPSIS
5 .B hg
6 .B clone
7 .B http://code.swtch.com/plan9port
8 .B plan9
9 .PP
10 .B hg
11 .B pull
12 .B -u
13 .PP
14 .B hg
15 .B diff
16 [
17 .B -r
18 .I revision
19 ]
20 [
21 .I path ...
22 ]
23 .PP
24 .B hg 
25 .B serve
26 .PP
27 .B hg 
28 .B view
29 .PP
30 .B web
31 .B http://code.swtch.com/plan9port
32 .SH DESCRIPTION
33 The master source tree for Plan 9 from User Space is maintained
34 using the source control system Mercurial
35 as a substitute for Plan 9's
36 \fIreplica\fR(8) and dump file system.
37 .PP
38 The first argument to
39 .I hg
40 is a command, which determines the form of the rest of the command line.
41 .PP
42 The
43 .B clone
44 command downloads a copy of the tree into the directory
45 .BR plan9 ,
46 which it will create.
47 After
48 .B hg
49 .BR clone ,
50 the other commands listed 
51 should be run within the
52 .B plan9
53 directory tree.
54 .PP
55 Unlike CVS, Mercurial downloads the entire revision history
56 of Plan 9 from User Space 
57 in addition to the current tree.
58 .PP
59 .I Hg
60 .I pull
61 incorporates changes from the master repository
62 into the local revision history.
63 The 
64 .B -u
65 flag applies these changes to the current file tree.
66 .PP
67 .I Hg
68 .I diff
69 runs Unix's
70 .IR diff (1)
71 to compare the files in the local tree with the corresponding
72 files in the revision history.
73 By default it compares against the version that was most recently
74 incorporated into the local tree.
75 The
76 .B -r
77 flag specifies an alternate version to compare against.
78 The special revision
79 .B tip
80 refers to the most recent version on the server.
81 .PP
82 .I Hg
83 .I serve
84 starts an HTTP server serving information about
85 the local repository at the address
86 .BR http://localhost:8000/ .
87 .PP
88 .I Hg
89 .I view
90 starts an interactive history viewer.
91 .PP
92 The Mercurial tree can be inspected on the web at
93 .HR http://code.swtch.com/plan9port/ "" .
94 .SH FILES
95 .TP
96 .B \*9/.hg
97 directory containing Mercurial local repository
98 .TP
99 .B .hgignore
100 list of files and wildcards to exclude from Mercurial operations
101 .SH SEE ALSO
102 .IR codereview (1)
103 .PP
104 Unix's
105 \fIhg\fR(1),
106 .HR http://www.selenic.com/mercurial/wiki/
107 .PP
108 .HR http://code.swtch.com/plan9port/
109 .SH BUGS
110 Plan 9 from User Space is no longer accessible using CVS;
111 you must use Mercurial.