28 indicates a changeset which can be specified as a changeset revision |
28 indicates a changeset which can be specified as a changeset revision |
29 number, a tag, or a unique substring of the changeset hash value |
29 number, a tag, or a unique substring of the changeset hash value |
30 |
30 |
31 repository path:: |
31 repository path:: |
32 either the pathname of a local repository or the URI of a remote |
32 either the pathname of a local repository or the URI of a remote |
33 repository. There are two available URI protocols, http:// which is |
33 repository. There are two available URI protocols, http:// which is |
34 fast and the static-http:// protocol which is much slower but does not |
34 fast and the static-http:// protocol which is much slower but does not |
35 require a special server on the web host. |
35 require a special server on the web host. |
36 |
36 |
37 |
37 |
38 include::hg.1.gendoc.txt[] |
38 include::hg.1.gendoc.txt[] |
41 --------------------------- |
41 --------------------------- |
42 |
42 |
43 Mercurial accepts several notations for identifying individual |
43 Mercurial accepts several notations for identifying individual |
44 revisions. |
44 revisions. |
45 |
45 |
46 A plain integer is treated as a revision number. Negative |
46 A plain integer is treated as a revision number. Negative |
47 integers are treated as offsets from the tip, with -1 denoting the |
47 integers are treated as offsets from the tip, with -1 denoting the |
48 tip. |
48 tip. |
49 |
49 |
50 A 40-digit hexadecimal string is treated as a unique revision |
50 A 40-digit hexadecimal string is treated as a unique revision |
51 identifier. |
51 identifier. |
52 |
52 |
53 A hexadecimal string less than 40 characters long is treated as a |
53 A hexadecimal string less than 40 characters long is treated as a |
54 unique revision identifier, and referred to as a short-form |
54 unique revision identifier, and referred to as a short-form |
55 identifier. A short-form identifier is only valid if it is the |
55 identifier. A short-form identifier is only valid if it is the |
56 prefix of one full-length identifier. |
56 prefix of one full-length identifier. |
57 |
57 |
58 Any other string is treated as a tag name, which is a symbolic |
58 Any other string is treated as a tag name, which is a symbolic |
59 name associated with a revision identifier. Tag names may not |
59 name associated with a revision identifier. Tag names may not |
60 contain the ":" character. |
60 contain the ":" character. |
61 |
61 |
62 The reserved name "tip" is a special tag that always identifies |
62 The reserved name "tip" is a special tag that always identifies |
63 the most recent revision. |
63 the most recent revision. |
64 |
64 |
76 When Mercurial accepts more than one revision, they may be |
76 When Mercurial accepts more than one revision, they may be |
77 specified individually, or provided as a continuous range, |
77 specified individually, or provided as a continuous range, |
78 separated by the ":" character. |
78 separated by the ":" character. |
79 |
79 |
80 The syntax of range notation is [BEGIN]:[END], where BEGIN and END |
80 The syntax of range notation is [BEGIN]:[END], where BEGIN and END |
81 are revision identifiers. Both BEGIN and END are optional. If |
81 are revision identifiers. Both BEGIN and END are optional. If |
82 BEGIN is not specified, it defaults to revision number 0. If END |
82 BEGIN is not specified, it defaults to revision number 0. If END |
83 is not specified, it defaults to the tip. The range ":" thus |
83 is not specified, it defaults to the tip. The range ":" thus |
84 means "all revisions". |
84 means "all revisions". |
85 |
85 |
86 If BEGIN is greater than END, revisions are treated in reverse |
86 If BEGIN is greater than END, revisions are treated in reverse |
87 order. |
87 order. |
88 |
88 |
89 A range acts as a closed interval. This means that a range of 3:5 |
89 A range acts as a closed interval. This means that a range of 3:5 |
90 gives 3, 4 and 5. Similarly, a range of 4:2 gives 4, 3, and 2. |
90 gives 3, 4 and 5. Similarly, a range of 4:2 gives 4, 3, and 2. |
91 |
91 |
92 FILES |
92 FILES |
93 ----- |
93 ----- |
94 repo/.hgignore:: |
94 repo/.hgignore:: |
95 This file contains regular expressions (one per line) that describe file |
95 This file contains regular expressions (one per line) that describe file |
101 contents. |
101 contents. |
102 |
102 |
103 /etc/mercurial/hgrc, $HOME/.hgrc, .hg/hgrc:: |
103 /etc/mercurial/hgrc, $HOME/.hgrc, .hg/hgrc:: |
104 This file contains defaults and configuration. Values in .hg/hgrc |
104 This file contains defaults and configuration. Values in .hg/hgrc |
105 override those in $HOME/.hgrc, and these override settings made in the |
105 override those in $HOME/.hgrc, and these override settings made in the |
106 global /etc/mercurial/hgrc configuration. See hgrc(5) for details of |
106 global /etc/mercurial/hgrc configuration. See hgrc(5) for details of |
107 the contents and format of these files. |
107 the contents and format of these files. |
108 |
108 |
109 Some commands (e.g. revert) produce backup files ending in .orig, if |
109 Some commands (e.g. revert) produce backup files ending in .orig, if |
110 the .orig file already exists and is not tracked by Mercurial, it |
110 the .orig file already exists and is not tracked by Mercurial, it |
111 will be overwritten. |
111 will be overwritten. |