hg.1.txt
138 lines
| 4.2 KiB
| text/plain
|
TextLexer
/ doc / hg.1.txt
|
r177 | HG(1) | ||
===== | ||||
Matt Mackall <mpm@selenic.com> | ||||
NAME | ||||
---- | ||||
|
r438 | hg - Mercurial source code management system | ||
|
r177 | |||
SYNOPSIS | ||||
-------- | ||||
|
r3544 | 'hg' [global option]... <command> [command/global option]... [argument]... | ||
|
r177 | |||
DESCRIPTION | ||||
----------- | ||||
The hg(1) command provides a command line interface to the Mercurial system. | ||||
COMMAND ELEMENTS | ||||
---------------- | ||||
files ...:: | ||||
|
r724 | indicates one or more filename or relative path filenames; see | ||
"FILE NAME PATTERNS" for information on pattern matching | ||||
|
r177 | |||
path:: | ||||
indicates a path on the local machine | ||||
|
r478 | revision:: | ||
|
r438 | indicates a changeset which can be specified as a changeset revision | ||
number, a tag, or a unique substring of the changeset hash value | ||||
|
r177 | |||
repository path:: | ||||
|
r498 | either the pathname of a local repository or the URI of a remote | ||
|
r6446 | repository. There are two available URI protocols, http:// which is | ||
|
r2431 | fast and the static-http:// protocol which is much slower but does not | ||
|
r438 | require a special server on the web host. | ||
|
r177 | |||
|
r438 | |||
|
r1814 | include::hg.1.gendoc.txt[] | ||
|
r438 | |||
|
r580 | SPECIFYING SINGLE REVISIONS | ||
--------------------------- | ||||
Mercurial accepts several notations for identifying individual | ||||
revisions. | ||||
|
r6446 | A plain integer is treated as a revision number. Negative | ||
|
r580 | integers are treated as offsets from the tip, with -1 denoting the | ||
tip. | ||||
A 40-digit hexadecimal string is treated as a unique revision | ||||
identifier. | ||||
A hexadecimal string less than 40 characters long is treated as a | ||||
unique revision identifier, and referred to as a short-form | ||||
|
r6446 | identifier. A short-form identifier is only valid if it is the | ||
|
r580 | prefix of one full-length identifier. | ||
Any other string is treated as a tag name, which is a symbolic | ||||
|
r6446 | name associated with a revision identifier. Tag names may not | ||
|
r580 | contain the ":" character. | ||
The reserved name "tip" is a special tag that always identifies | ||||
the most recent revision. | ||||
|
r5296 | The reserved name "null" indicates the null revision. This is the | ||
revision of an empty repository, and the parent of revision 0. | ||||
The reserved name "." indicates the working directory parent. If | ||||
no working directory is checked out, it is equivalent to null. | ||||
If an uncommitted merge is in progress, "." is the revision of | ||||
the first parent. | ||||
|
r580 | SPECIFYING MULTIPLE REVISIONS | ||
----------------------------- | ||||
When Mercurial accepts more than one revision, they may be | ||||
specified individually, or provided as a continuous range, | ||||
separated by the ":" character. | ||||
The syntax of range notation is [BEGIN]:[END], where BEGIN and END | ||||
|
r6446 | are revision identifiers. Both BEGIN and END are optional. If | ||
BEGIN is not specified, it defaults to revision number 0. If END | ||||
is not specified, it defaults to the tip. The range ":" thus | ||||
|
r580 | means "all revisions". | ||
If BEGIN is greater than END, revisions are treated in reverse | ||||
order. | ||||
|
r6446 | A range acts as a closed interval. This means that a range of 3:5 | ||
gives 3, 4 and 5. Similarly, a range of 4:2 gives 4, 3, and 2. | ||||
|
r196 | |||
|
r177 | FILES | ||
----- | ||||
|
r5576 | repo/.hgignore:: | ||
|
r438 | This file contains regular expressions (one per line) that describe file | ||
|
r2209 | names that should be ignored by hg. For details, see hgignore(5). | ||
|
r177 | |||
|
r5576 | repo/.hgtags:: | ||
|
r438 | This file contains changeset hash values and text tag names (one of each | ||
|
r1045 | separated by spaces) that correspond to tagged versions of the repository | ||
|
r177 | contents. | ||
|
r951 | /etc/mercurial/hgrc, $HOME/.hgrc, .hg/hgrc:: | ||
|
r438 | This file contains defaults and configuration. Values in .hg/hgrc | ||
|
r951 | override those in $HOME/.hgrc, and these override settings made in the | ||
|
r6446 | global /etc/mercurial/hgrc configuration. See hgrc(5) for details of | ||
|
r951 | the contents and format of these files. | ||
|
r321 | |||
|
r3021 | Some commands (e.g. revert) produce backup files ending in .orig, if | ||
the .orig file already exists and is not tracked by Mercurial, it | ||||
will be overwritten. | ||||
|
r177 | BUGS | ||
---- | ||||
Probably lots, please post them to the mailing list (See Resources below) | ||||
when you find them. | ||||
|
r671 | SEE ALSO | ||
-------- | ||||
|
r2209 | hgignore(5), hgrc(5) | ||
|
r671 | |||
|
r177 | AUTHOR | ||
------ | ||||
Written by Matt Mackall <mpm@selenic.com> | ||||
RESOURCES | ||||
--------- | ||||
http://selenic.com/mercurial[Main Web Site] | ||||
http://selenic.com/hg[Source code repository] | ||||
http://selenic.com/mailman/listinfo/mercurial[Mailing list] | ||||
COPYING | ||||
------- | ||||
|
r4635 | Copyright \(C) 2005-2007 Matt Mackall. | ||
|
r177 | Free use of this software is granted under the terms of the GNU General | ||
Public License (GPL). | ||||