1 .TH HG 1
2 .SH NAME 
3 git, hg, cvs \- introduction to using plan9port Git repository
4 .SH SYNOPSIS
5 .B git
6 .B clone
7 .B http://code.swtch.com/plan9port
8 .B plan9
9 .PP
10 .B git
11 .B pull
12 .PP
13 .B git
14 .B diff
15 .I revision
16 [
17 .I path ...
18 ]
19 .PP
20 .B gitk 
21 .PP
22 .B web
23 .B http://code.swtch.com/plan9port
24 .SH DESCRIPTION
25 The master source tree for Plan 9 from User Space is maintained
26 using the source control system Git
27 as a substitute for Plan 9's
28 \fIreplica\fR(8) and dump file system.
29 .PP
30 The first argument to
31 .I git
32 is a command, which determines the form of the rest of the command line.
33 .PP
34 The
35 .B clone
36 command downloads a copy of the tree into the directory
37 .BR plan9 ,
38 which it will create.
39 After
40 .B git
41 .BR clone ,
42 the other commands listed 
43 should be run within the
44 .B plan9
45 directory tree.
46 .PP
47 Git downloads the entire revision history
48 of Plan 9 from User Space 
49 in addition to the current tree.
50 .PP
51 .I Git
52 .I pull
53 incorporates changes from the master repository
54 into the local revision history and applies them to the
55 current file tree.
56 .PP
57 .I Git
58 .I diff
59 runs Unix's
60 .IR diff (1)
61 to compare the files in the local tree with the corresponding
62 files in the revision history.
63 The special revision
64 .B HEAD
65 refers to the most recent version in the version history.
66 .PP
67 .I Gitk
68 starts an interactive history viewer.
69 .PP
70 The Git tree can be inspected on the web at
71 .HR http://code.swtch.com/plan9port/ "" .
72 .SH FILES
73 .TP
74 .B \*9/.git
75 directory containing Git local repository
76 .TP
77 .B .gitignore
78 list of files and wildcards to exclude from Git operations
79 .SH SEE ALSO
80 .IR codereview (1)
81 .PP
82 Unix's
83 \fIgit\fR(1),
84 .HR http://git-scm.com/doc
85 .PP
86 .HR http://code.swtch.com/plan9port/
87 .SH BUGS
88 Plan 9 from User Space is no longer accessible using CVS or Mercurial;
89 you must use Git.