1 .TH HG 1
2 .SH NAME 
3 hg \- introduction to using plan9port Mercurial repository
4 .SH SYNOPSIS
5 .B hg
6 .B clone
7 .B http://hg.pdos.csail.mit.edu/hg/plan9
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://hg.pdos.csail.mit.edu/hg/plan9/
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 (It is maintained simultaneously using CVS; see
38 .IR cvs (1).)
39 .PP
40 The first argument to
41 .I hg
42 is a command, which determines the form of the rest of the command line.
43 .PP
44 The
45 .B clone
46 command downloads a copy of the tree into the directory
47 .BR plan9 ,
48 which it will create.
49 After
50 .B hg
51 .BR clone ,
52 the other commands listed 
53 should be run within the
54 .B plan9
55 directory tree.
56 .PP
57 Unlike CVS, Mercurial downloads the entire revision history
58 of Plan 9 from User Space 
59 in addition to the current tree.
60 .PP
61 .I Hg
62 .I pull
63 incorporates changes from the master repository
64 into the local revision history.
65 The 
66 .B -u
67 flag applies these changes to the current file tree.
68 .PP
69 .I Hg
70 .I diff
71 runs Unix's
72 .IR diff (1)
73 to compare the files in the local tree with the corresponding
74 files in the revision history.
75 By default it compares against the version that was most recently
76 incorporated into the local tree.
77 The
78 .B -r
79 flag specifies an alternate version to compare against.
80 The special revision
81 .B tip
82 refers to the most recent version on the server.
83 .PP
84 .I Hg
85 .I serve
86 starts an HTTP server serving information about
87 the local repository at the address
88 .BR http://localhost:8000/ .
89 .PP
90 .I Hg
91 .I view
92 starts an interactive history viewer.
93 .PP
94 The Mercurial tree can be inspected on the web at
95 .HR http://hg.pdos.csail.mit.edu/hg/plan9/ "" .
96 .SH FILES
97 .TP
98 .B \*9/.hg
99 directory containing Mercurial local repository
100 .TP
101 .B .hgignore
102 list of files and wildcards to exclude from Mercurial operations
103 .SH SEE ALSO
104 .IR cvs (1)
105 .PP
106 Unix's
107 \fIhg\fR(1),
108 .HR http://www.selenic.com/mercurial/wiki/
109 .PP
110 .HR http://hg.pdos.csail.mit.edu/hg/plan9/
111 .SH BUGS
112 The use of Mercurial for accessing Plan 9 from User Space
113 should be considered experimental.
114 People uncomfortable with Mercurial should continue to use
115 .IR cvs (1).