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