| HG(1) | HG(1)

NAME

| hg – introduction to using plan9port Mercurial repository

SYNOPSIS

`hg clone http://hg.pdos.csail.mit.edu/hg/plan9 plan9

` `hg pull −u

` `hg diff` [ `−r` revision ] [ path ... ]

`hg serve

` `hg view

` `web http://hg.pdos.csail.mit.edu/hg/plan9/
`

DESCRIPTION

The master source tree for Plan 9 from User Space is maintained using the source control system Mercurial as a substitute for Plan 9’s replica(8) and dump file system. (It is maintained simultaneously using CVS; see cvs(1).)

The first argument to hg is a command, which determines the form of the rest of the command line.

The `clone` command downloads a copy of the tree into the directory `plan9`, which it will create. After `hg clone`, the other commands listed should be run within the `plan9` directory tree.

Unlike CVS, Mercurial downloads the entire revision history of Plan 9 from User Space in addition to the current tree.

Hg pull incorporates changes from the master repository into the local revision history. The `−u` flag applies these changes to the current file tree.

Hg diff runs Unix’s diff(1) to compare the files in the local tree with the corresponding files in the revision history. By default it compares against the version that was most recently incorporated into the local tree. The `−r` flag specifies an alternate version to compare against. The special revision `tip` refers to the most recent version on the server.

Hg serve starts an HTTP server serving information about the local repository at the address `http://localhost:8000/`.

Hg view starts an interactive history viewer.

The Mercurial tree can be inspected on the web at `http://hg.pdos.csail.mit.edu/hg/plan9/`.

FILES

`/usr/local/plan9/.hg
`

| directory containing Mercurial local repository

`.hgignore
`

| list of files and wildcards to exclude from Mercurial operations

SEE ALSO

cvs(1)

Unix’s hg(1), `http://www.selenic.com/mercurial/wiki/`

`http://hg.pdos.csail.mit.edu/hg/plan9/`

BUGS

| The use of Mercurial for accessing Plan 9 from User Space should be considered experimental. People uncomfortable with Mercurial should continue to use cvs(1).