| .TH HG 1 |
| .SH NAME |
| git, hg, cvs \- introduction to using plan9port Git repository |
| .SH SYNOPSIS |
| .B git |
| .B clone |
| .B http://code.swtch.com/plan9port |
| .B plan9 |
| .PP |
| .B git |
| .B pull |
| .PP |
| .B git |
| .B diff |
| .I revision |
| [ |
| .I path ... |
| ] |
| .PP |
| .B gitk |
| .PP |
| .B web |
| .B http://code.swtch.com/plan9port |
| .SH DESCRIPTION |
| The master source tree for Plan 9 from User Space is maintained |
| using the source control system Git |
| as a substitute for Plan 9's |
| \fIreplica\fR(8) and dump file system. |
| .PP |
| The first argument to |
| .I git |
| 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 git |
| .BR clone , |
| the other commands listed |
| should be run within the |
| .B plan9 |
| directory tree. |
| .PP |
| Git downloads the entire revision history |
| of Plan 9 from User Space |
| in addition to the current tree. |
| .PP |
| .I Git |
| .I pull |
| incorporates changes from the master repository |
| into the local revision history and applies them to the |
| current file tree. |
| .PP |
| .I Git |
| .I diff |
| runs Unix's |
| .IR diff (1) |
| to compare the files in the local tree with the corresponding |
| files in the revision history. |
| The special revision |
| .B HEAD |
| refers to the most recent version in the version history. |
| .PP |
| .I Gitk |
| starts an interactive history viewer. |
| .PP |
| The Git tree can be inspected on the web at |
| .HR http://code.swtch.com/plan9port/ "" . |
| .SH FILES |
| .TP |
| .B \*9/.git |
| directory containing Git local repository |
| .TP |
| .B .gitignore |
| list of files and wildcards to exclude from Git operations |
| .SH SEE ALSO |
| .IR codereview (1) |
| .PP |
| Unix's |
| \fIgit\fR(1), |
| .HR http://git-scm.com/doc |
| .PP |
| .HR http://code.swtch.com/plan9port/ |
| .SH BUGS |
| Plan 9 from User Space is no longer accessible using CVS or Mercurial; |
| you must use Git. |
