plan9port/man/man1/git.1
Russ Cox 95fee1d42e all: update for Git
- rewrite .gitignore to use git patterns
- mv hg(1) to git(1) and rewrite
- add lib/git/commit-msg.hook
- add skeleton codereview script
- update codereview(1)

Change-Id: I061cd8e4de77ebbd6037a7c5d1582cd1d986f62f
2014-11-16 21:21:28 -05:00

89 lines
1.7 KiB
Groff

.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 Mercurial 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.