author | Matt Mackall <mpm@selenic.com> |
Thu, 18 Jun 2009 16:56:03 -0500 | |
changeset 8831 | 91e26fb24fb1 |
parent 8775 | 8e15f4afdf06 |
child 8936 | 1de6e7e1bb9f |
permissions | -rw-r--r-- |
177 | 1 |
HG(1) |
2 |
===== |
|
3 |
Matt Mackall <mpm@selenic.com> |
|
8772
593d772434f7
man pages: add meta data
Martin Geisler <mg@lazybytes.net>
parents:
8771
diff
changeset
|
4 |
:man source: Mercurial |
593d772434f7
man pages: add meta data
Martin Geisler <mg@lazybytes.net>
parents:
8771
diff
changeset
|
5 |
:man manual: Mercurial Manual |
177 | 6 |
|
7 |
NAME |
|
8 |
---- |
|
438 | 9 |
hg - Mercurial source code management system |
177 | 10 |
|
11 |
SYNOPSIS |
|
12 |
-------- |
|
8774 | 13 |
*hg* 'command' ['option']... ['argument']... |
177 | 14 |
|
15 |
DESCRIPTION |
|
16 |
----------- |
|
8775
8e15f4afdf06
hg.1: highlight references to commands and man pages
Martin Geisler <mg@lazybytes.net>
parents:
8774
diff
changeset
|
17 |
The *hg* command provides a command line interface to the Mercurial |
8728
9d67706ee8d5
hg.1: wrap lines at 70 chars (whitespace cleanup)
Martin Geisler <mg@lazybytes.net>
parents:
7211
diff
changeset
|
18 |
system. |
177 | 19 |
|
20 |
COMMAND ELEMENTS |
|
21 |
---------------- |
|
22 |
||
23 |
files ...:: |
|
724
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
24 |
indicates one or more filename or relative path filenames; see |
1c0c413cccdd
Get add and locate to use new repo and dirstate walk code.
Bryan O'Sullivan <bos@serpentine.com>
parents:
671
diff
changeset
|
25 |
"FILE NAME PATTERNS" for information on pattern matching |
177 | 26 |
|
27 |
path:: |
|
28 |
indicates a path on the local machine |
|
29 |
||
478
f1804f2e7f35
Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents:
438
diff
changeset
|
30 |
revision:: |
8728
9d67706ee8d5
hg.1: wrap lines at 70 chars (whitespace cleanup)
Martin Geisler <mg@lazybytes.net>
parents:
7211
diff
changeset
|
31 |
indicates a changeset which can be specified as a changeset |
9d67706ee8d5
hg.1: wrap lines at 70 chars (whitespace cleanup)
Martin Geisler <mg@lazybytes.net>
parents:
7211
diff
changeset
|
32 |
revision number, a tag, or a unique substring of the changeset |
9d67706ee8d5
hg.1: wrap lines at 70 chars (whitespace cleanup)
Martin Geisler <mg@lazybytes.net>
parents:
7211
diff
changeset
|
33 |
hash value |
177 | 34 |
|
35 |
repository path:: |
|
498 | 36 |
either the pathname of a local repository or the URI of a remote |
7211 | 37 |
repository. |
438 | 38 |
|
1814
7956893e8458
generate hg manpage from commands.py docstring
Benoit Boissinot <benoit.boissinot@ens-lyon.org>
parents:
1758
diff
changeset
|
39 |
include::hg.1.gendoc.txt[] |
438 | 40 |
|
177 | 41 |
FILES |
42 |
----- |
|
8766
b2059435f176
man pages: mark filenames and env vars as fixed text
Martin Geisler <mg@lazybytes.net>
parents:
8728
diff
changeset
|
43 |
`.hgignore`:: |
8728
9d67706ee8d5
hg.1: wrap lines at 70 chars (whitespace cleanup)
Martin Geisler <mg@lazybytes.net>
parents:
7211
diff
changeset
|
44 |
This file contains regular expressions (one per line) that |
8775
8e15f4afdf06
hg.1: highlight references to commands and man pages
Martin Geisler <mg@lazybytes.net>
parents:
8774
diff
changeset
|
45 |
describe file names that should be ignored by *hg*. For details, |
8e15f4afdf06
hg.1: highlight references to commands and man pages
Martin Geisler <mg@lazybytes.net>
parents:
8774
diff
changeset
|
46 |
see *hgignore(5)*. |
177 | 47 |
|
8766
b2059435f176
man pages: mark filenames and env vars as fixed text
Martin Geisler <mg@lazybytes.net>
parents:
8728
diff
changeset
|
48 |
`.hgtags`:: |
8728
9d67706ee8d5
hg.1: wrap lines at 70 chars (whitespace cleanup)
Martin Geisler <mg@lazybytes.net>
parents:
7211
diff
changeset
|
49 |
This file contains changeset hash values and text tag names (one |
9d67706ee8d5
hg.1: wrap lines at 70 chars (whitespace cleanup)
Martin Geisler <mg@lazybytes.net>
parents:
7211
diff
changeset
|
50 |
of each separated by spaces) that correspond to tagged versions of |
9d67706ee8d5
hg.1: wrap lines at 70 chars (whitespace cleanup)
Martin Geisler <mg@lazybytes.net>
parents:
7211
diff
changeset
|
51 |
the repository contents. |
177 | 52 |
|
8766
b2059435f176
man pages: mark filenames and env vars as fixed text
Martin Geisler <mg@lazybytes.net>
parents:
8728
diff
changeset
|
53 |
`/etc/mercurial/hgrc`, `$HOME/.hgrc`, `.hg/hgrc`:: |
b2059435f176
man pages: mark filenames and env vars as fixed text
Martin Geisler <mg@lazybytes.net>
parents:
8728
diff
changeset
|
54 |
This file contains defaults and configuration. Values in `.hg/hgrc` |
b2059435f176
man pages: mark filenames and env vars as fixed text
Martin Geisler <mg@lazybytes.net>
parents:
8728
diff
changeset
|
55 |
override those in `$HOME/.hgrc`, and these override settings made in |
8775
8e15f4afdf06
hg.1: highlight references to commands and man pages
Martin Geisler <mg@lazybytes.net>
parents:
8774
diff
changeset
|
56 |
the global `/etc/mercurial/hgrc` configuration. See *hgrc(5)* for |
8728
9d67706ee8d5
hg.1: wrap lines at 70 chars (whitespace cleanup)
Martin Geisler <mg@lazybytes.net>
parents:
7211
diff
changeset
|
57 |
details of the contents and format of these files. |
321 | 58 |
|
8766
b2059435f176
man pages: mark filenames and env vars as fixed text
Martin Geisler <mg@lazybytes.net>
parents:
8728
diff
changeset
|
59 |
Some commands (e.g. revert) produce backup files ending in `.orig`, if |
b2059435f176
man pages: mark filenames and env vars as fixed text
Martin Geisler <mg@lazybytes.net>
parents:
8728
diff
changeset
|
60 |
the `.orig` file already exists and is not tracked by Mercurial, it will |
8728
9d67706ee8d5
hg.1: wrap lines at 70 chars (whitespace cleanup)
Martin Geisler <mg@lazybytes.net>
parents:
7211
diff
changeset
|
61 |
be overwritten. |
3021
b9dbbcf8a488
Document the fact that revert might overwrite .orig files
Benoit Boissinot <benoit.boissinot@ens-lyon.org>
parents:
2859
diff
changeset
|
62 |
|
177 | 63 |
BUGS |
64 |
---- |
|
8728
9d67706ee8d5
hg.1: wrap lines at 70 chars (whitespace cleanup)
Martin Geisler <mg@lazybytes.net>
parents:
7211
diff
changeset
|
65 |
Probably lots, please post them to the mailing list (See Resources |
9d67706ee8d5
hg.1: wrap lines at 70 chars (whitespace cleanup)
Martin Geisler <mg@lazybytes.net>
parents:
7211
diff
changeset
|
66 |
below) when you find them. |
177 | 67 |
|
671
efa4a7e2f322
Move hgrc documentation out to its own man page, hgrc(5).
Bryan O'Sullivan <bos@serpentine.com>
parents:
631
diff
changeset
|
68 |
SEE ALSO |
efa4a7e2f322
Move hgrc documentation out to its own man page, hgrc(5).
Bryan O'Sullivan <bos@serpentine.com>
parents:
631
diff
changeset
|
69 |
-------- |
8775
8e15f4afdf06
hg.1: highlight references to commands and man pages
Martin Geisler <mg@lazybytes.net>
parents:
8774
diff
changeset
|
70 |
*hgignore(5)*, *hgrc(5)* |
671
efa4a7e2f322
Move hgrc documentation out to its own man page, hgrc(5).
Bryan O'Sullivan <bos@serpentine.com>
parents:
631
diff
changeset
|
71 |
|
177 | 72 |
AUTHOR |
73 |
------ |
|
74 |
Written by Matt Mackall <mpm@selenic.com> |
|
75 |
||
76 |
RESOURCES |
|
77 |
--------- |
|
78 |
http://selenic.com/mercurial[Main Web Site] |
|
79 |
||
80 |
http://selenic.com/hg[Source code repository] |
|
81 |
||
82 |
http://selenic.com/mailman/listinfo/mercurial[Mailing list] |
|
83 |
||
84 |
COPYING |
|
85 |
------- |
|
8771
a2871de50f50
man pages: updated copyright years
Martin Geisler <mg@lazybytes.net>
parents:
8766
diff
changeset
|
86 |
Copyright \(C) 2005-2009 Matt Mackall. |
177 | 87 |
Free use of this software is granted under the terms of the GNU General |
88 |
Public License (GPL). |