doc/hg.1.txt
author Thomas Arendsen Hein <thomas@intevation.de>
Mon, 27 Jun 2005 06:41:28 +0100
changeset 491 66eb9905d0a2
parent 485 c5705ab9cebd
child 487 2ad41189bee5
child 495 e94cebc60d96
permissions -rw-r--r--
Fixed test-flags and .out for arbitrary umask settings. Use -ex shell flags. -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Fixed test-flags and .out for arbitrary umask settings. Use -ex shell flags. manifest hash: b6c5a0bb17de794fc5822b0672af8b977bd77950 -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.1 (GNU/Linux) iD8DBQFCv5GIW7P1GVgWeRoRAimoAJ9s2RlZ3ljH8DZE2vbCmoWJX973LQCglo+s GmajRX7o3kJxY88aNGy+TNs= =TKmo -----END PGP SIGNATURE-----
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
     1
HG(1)
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
     2
=====
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
     3
Matt Mackall <mpm@selenic.com>
478
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
     4
v0.6, 24 Jun 2005
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
     5
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
     6
NAME
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
     7
----
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
     8
hg - Mercurial source code management system
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
     9
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    10
SYNOPSIS
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    11
--------
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    12
'hg' [-v -d -q -y] <command> [command options] [files]
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    13
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    14
DESCRIPTION
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    15
-----------
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    16
The hg(1) command provides a command line interface to the Mercurial system.
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    17
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    18
OPTIONS
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    19
-------
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
    20
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    21
--debug, -d::
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    22
    enable debugging output
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    23
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    24
--quiet, -q::
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    25
    suppress output
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    26
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    27
--verbose, -v::
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    28
    enable additional output
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    29
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    30
--noninteractive, -y::
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    31
    do not prompt, assume 'yes' for any required answers
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    32
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    33
COMMAND ELEMENTS
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    34
----------------
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    35
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    36
files ...::
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    37
    indicates one or more filename or relative path filenames
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    38
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    39
path::
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    40
    indicates a path on the local machine
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    41
478
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
    42
revision::
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
    43
    indicates a changeset which can be specified as a changeset revision
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
    44
    number, a tag, or a unique substring of the changeset hash value
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    45
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    46
repository path::
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    47
    is either the pathname of a local repository of the URI of a remote
181
038e4d8602bd updated for .hgpaths and http/old-http protocol name change
jake@edge2.net
parents: 177
diff changeset
    48
    repository.  There are two available URI protocols, http:// which is
478
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
    49
    fast and the old-http:// protocol which is much slower but does not
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
    50
    require a special server on the web host.
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    51
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    52
COMMANDS
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    53
--------
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
    54
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    55
add [files ...]::
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
    56
    Add the given files to the repository.  Note that this just schedules the
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    57
    files for addition at the next hg commit time.
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    58
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    59
addremove::
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
    60
    Add all new files and remove all missing files from the repository.  New
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    61
    files are ignored if they match any of the patterns in .hgignore
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    62
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
    63
annotate [-r <rev> -u -n -c] [files ...]::
478
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
    64
    List the files with each line showing the revision id responsible
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
    65
    for that line.
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    66
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
    67
    options:
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
    68
    -r, --revision <rev>  annotate the specified revision
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
    69
    -u, --user            list the author
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
    70
    -c, --changeset       list the changeset
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
    71
    -n, --number          list the revision number (default)
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    72
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
    73
cat <file> [revision]::
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
    74
    Output the given revision or tip of the specified file to stdout.
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    75
485
c5705ab9cebd [PATCH] add clone command
mpm@selenic.com
parents: 484
diff changeset
    76
clone [-U] <source> [dest]::
c5705ab9cebd [PATCH] add clone command
mpm@selenic.com
parents: 484
diff changeset
    77
    Create a new copy of an existing repository.
c5705ab9cebd [PATCH] add clone command
mpm@selenic.com
parents: 484
diff changeset
    78
c5705ab9cebd [PATCH] add clone command
mpm@selenic.com
parents: 484
diff changeset
    79
    If the specified source is on the same filesystem, the repository
c5705ab9cebd [PATCH] add clone command
mpm@selenic.com
parents: 484
diff changeset
    80
    will be copied via hardlinks. This is the fastest and most
c5705ab9cebd [PATCH] add clone command
mpm@selenic.com
parents: 484
diff changeset
    81
    space-efficient mode of operation.
c5705ab9cebd [PATCH] add clone command
mpm@selenic.com
parents: 484
diff changeset
    82
c5705ab9cebd [PATCH] add clone command
mpm@selenic.com
parents: 484
diff changeset
    83
    If the destination directory is not specified, it defaults to the
c5705ab9cebd [PATCH] add clone command
mpm@selenic.com
parents: 484
diff changeset
    84
    current directory.
c5705ab9cebd [PATCH] add clone command
mpm@selenic.com
parents: 484
diff changeset
    85
c5705ab9cebd [PATCH] add clone command
mpm@selenic.com
parents: 484
diff changeset
    86
    If the destination is specified, but does not exist, it is created.
c5705ab9cebd [PATCH] add clone command
mpm@selenic.com
parents: 484
diff changeset
    87
c5705ab9cebd [PATCH] add clone command
mpm@selenic.com
parents: 484
diff changeset
    88
    The source is added to .hg/hgrc in the new copy as the default for
c5705ab9cebd [PATCH] add clone command
mpm@selenic.com
parents: 484
diff changeset
    89
    future pulls.
c5705ab9cebd [PATCH] add clone command
mpm@selenic.com
parents: 484
diff changeset
    90
c5705ab9cebd [PATCH] add clone command
mpm@selenic.com
parents: 484
diff changeset
    91
    options:
c5705ab9cebd [PATCH] add clone command
mpm@selenic.com
parents: 484
diff changeset
    92
    -U, --no-update   do not update the new working directory
c5705ab9cebd [PATCH] add clone command
mpm@selenic.com
parents: 484
diff changeset
    93
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
    94
commit [-A -t -l <file> -t <text> -u <user> -d <datecode>] [files...]::
478
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
    95
    Commit all changed files in the working dir to the repository.  This uses
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    96
    the EDITOR environment variable to bring up an editor to add a commit
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    97
    comment.
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
    98
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
    99
    Options:
478
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   100
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   101
    -A, --addremove       run addremove during commit
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   102
    -t, --text <text>     use <text> as commit message
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   103
    -l, --logfile <file>  read the commit message from the specified
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   104
                          file
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   105
    -d, --date <datecode> use the specified date code
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   106
    -u, --user <user>     record commit as the specified user
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   107
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   108
    aliases: ci
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   109
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   110
copy <source> <dest>::
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   111
    Mark a file as copied or renamed for the next commit.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   112
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   113
diff [-r revision] [-r revision] [files ...]::
478
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   114
    Generate a unified diff of the indicated files. If there are no
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   115
    revisions specified, the working directory file is compared to
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   116
    the tip, one revision specified indicates a comparison between the
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   117
    working directory file and the specified revision, and two revisions
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   118
    compares the two versions specified.
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   119
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   120
export [revision]::
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   121
    Print the changeset header (author, changeset hash, parent, and commit
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   122
    comment) and the diffs for a particular revision.
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   123
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   124
forget [files]::
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   125
    Undo an 'hg add' scheduled for the next commit.
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   126
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   127
heads::
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   128
    Show all changesets with no children. These are the "heads" of
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   129
    development branches and are the usual targets for updates and merges.
196
48827121af7e add export, recover, and undo to the man page
jake@edge2.net
parents: 182
diff changeset
   130
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   131
history::
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   132
    Print the revision history of the repository. Use the -v switch
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   133
    for more detail.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   134
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   135
identify::
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   136
    Print a short identifier of the current state of the repo. This
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   137
    includes one or two parent hash identifiers, followed by
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   138
    a "+" if there are uncommitted changes in the working directory,
478
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   139
    followed by a list of tags for this revision.
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   140
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   141
    aliases: id
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   142
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   143
import [-p <n> -b <base> -q] <patches>::
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   144
    Import the listed patches and commit them individually.
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   145
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   146
    options:
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   147
    -p, --strip <n>   directory strip option for patch
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   148
    -b <path>         base directory to read patches from
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   149
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   150
    aliases: patch
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   151
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   152
init [-u] [source]::
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   153
    Initialize a repository in the current directory.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   154
485
c5705ab9cebd [PATCH] add clone command
mpm@selenic.com
parents: 484
diff changeset
   155
    NOTE: The following use is deprecated, and will be removed soon;
c5705ab9cebd [PATCH] add clone command
mpm@selenic.com
parents: 484
diff changeset
   156
    use the "hg clone" command instead.
c5705ab9cebd [PATCH] add clone command
mpm@selenic.com
parents: 484
diff changeset
   157
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   158
    If a source is specified, pull that source into the repository.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   159
    This source is added to .hg/hgrc as the default for future pulls
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   160
    in this repository.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   161
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   162
    If the specified source is on the same filesystem, the repository
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   163
    will be copied via hardlinks. This is the fastest and most
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   164
    space-efficient mode of operation.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   165
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   166
    options:
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   167
    -u, --update   update the working directory to match the tip
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   168
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   169
log <file>::
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   170
    Print the revision history of the specified file.
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   171
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   172
manifest [revision]::
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   173
    Print the indicated revision of the manifest (list of version controlled
478
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   174
    files).
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   175
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   176
parents::
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   177
    Print the working directory's parent revisions.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   178
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   179
pull <repository path>::
478
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   180
    Pull any changes from the specified repository to the repository in the
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   181
    current directory.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   182
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   183
    options:
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   184
    -u, --update   update the working directory to tip after pull
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   185
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   186
push <destination>::
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   187
    Push changes from the local repository to the specified
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   188
    destination. If the destination is local, this is identical to a
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   189
    a pull in that directory from the current directory.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   190
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   191
    The other currently available push method is SSH. This requires an
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   192
    accessible shell account on the destination machine and a copy of
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   193
    hg in the remote path. Destinations are specified in the following
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   194
    form:
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   195
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   196
      ssh://[user@]host[:port]/path
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   197
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   198
rawcommit [-p -d -u -F -t -l]::
478
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   199
    Primarily useful for importing from other SCMs.
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   200
196
48827121af7e add export, recover, and undo to the man page
jake@edge2.net
parents: 182
diff changeset
   201
recover::
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   202
    Recover from an interrupted commit or pull. This should only be
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   203
    necessary when Mercurial suggests it.
196
48827121af7e add export, recover, and undo to the man page
jake@edge2.net
parents: 182
diff changeset
   204
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   205
remove [files ...]::
478
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   206
    Schedule the indicated files for removal from the repository at the next
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   207
    commit.
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   208
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   209
    aliases: rm
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   210
478
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   211
root::
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   212
    Print the root directory of the current repository.
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   213
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   214
serve [-a addr -n name -p port -t templatedir]::
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   215
    Start a local HTTP repository browser and pull server.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   216
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   217
    options:
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   218
    -a, --address <addr> address to use
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   219
    -p, --port <n>       port to use (default: 8000)
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   220
    -n, --name <name>    name to show in web pages (default: working dir)
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   221
    -t, --templatedir <path> web templates to use
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   222
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   223
status::
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   224
    Show changed files in the working directory.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   225
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   226
    C = changed
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   227
    A = added
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   228
    R = removed
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   229
    ? = not tracked
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   230
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   231
tag [-t <text> -d <datecode> -u <user>] <name> [revision]::
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   232
    Add a tag <name> to the specified revision or the tip.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   233
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   234
    options:
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   235
    -t, --text <text>     message for tag commit log entry
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   236
    -d, --date <datecode> datecode for commit
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   237
    -u, --user <user>     user for commit
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   238
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   239
tags::
478
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   240
    List the repository tags.
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   241
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   242
tip::
478
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   243
    Show the tip revision.
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   244
196
48827121af7e add export, recover, and undo to the man page
jake@edge2.net
parents: 182
diff changeset
   245
undo::
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   246
    Undo the last commit or pull transaction.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   247
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   248
update [-m -C] [revision]::
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   249
    Update or merge the working directory to a specified revision.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   250
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   251
    If there are no outstanding changes in the working directory and
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   252
    there is a linear relationship between the current version and the
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   253
    requested version, the result is the requested version.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   254
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   255
    Otherwise the result is a merge between the contents of the
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   256
    current working directory and the requested version. Files that
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   257
    changed between either parent are marked as changed for the next
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   258
    commit and a commit must be performed before any further updates
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   259
    are allowed. Merging will not be performed without the -m flag.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   260
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   261
    The -C switch will tell Mercurial to forcibly update to the
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   262
    specified version, adding, removing, and overwriting locally
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   263
    changed fils as necessary.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   264
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   265
    options:
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   266
    -m, --merge       allow merging of branches
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   267
    -C, --clean       overwrite locally modified files
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   268
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   269
    aliases: up checkout co
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   270
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   271
verify::
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   272
    Verify the integrity of the current repository.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   273
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   274
    This will perform an extensive check of the repository's
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   275
    integrity, validating the hashes and checksums of each entry in
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   276
    the changelog, manifest, and tracked files, as well as the
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   277
    integrity of their crosslinks and indices.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   278
196
48827121af7e add export, recover, and undo to the man page
jake@edge2.net
parents: 182
diff changeset
   279
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   280
ENVIRONMENT VARIABLES
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   281
---------------------
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   282
478
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   283
HGEDITOR::
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   284
    This is the name of the editor to use when committing. Defaults to the
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   285
    value of EDITOR.
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   286
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   287
HGMERGE::
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   288
    An executable to use for resolving merge conflicts. The program ,
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   289
    will be executed with three arguments: local file, remote file,
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   290
    ancestor file.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   291
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   292
    The default program is "hgmerge", which is a shell script provided
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   293
    by Mercurial with some sensible defaults.
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   294
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   295
HGUSER::
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   296
    This is the string used for the author of a commit.
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   297
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   298
EMAIL::
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   299
    If HGUSER is not set, this will be used as the author for a commit.
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   300
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   301
LOGNAME::
478
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   302
    If neither HGUSER nor EMAIL is set, LOGNAME will be used (with
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   303
    '@hostname' appended) as the author value for a commit.
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   304
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   305
EDITOR::
478
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   306
    This is the name of the editor used in the hgmerge script. It will be
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   307
    used for commit messages, too, if HGEDITOR isn't set. Defaults to 'vi'.
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   308
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   309
PYTHONPATH::
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   310
    This is used by Python to find imported modules and may need to be set
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   311
    appropriately if Mercurial is not installed system-wide.
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   312
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   313
FILES
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   314
-----
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   315
 .hgignore::
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   316
    This file contains regular expressions (one per line) that describe file
478
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   317
    names that should be ignored by hg.
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   318
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   319
 .hgtags::
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   320
    This file contains changeset hash values and text tag names (one of each
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   321
    seperated by spaces) that correspond to tagged versions of the repository
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   322
    contents.
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   323
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   324
 $HOME/.hgrc, .hg/hgrc::
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   325
    This file contains defaults and configuration. Values in .hg/hgrc
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   326
    override those in .hgrc.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   327
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   328
NAMED REPOSITORIES
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   329
------------------
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   330
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   331
    To give symbolic names to a repository, create a section in .hgrc
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   332
    or .hg/hgrc containing assignments of names to paths.
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   333
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   334
    Example:
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   335
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   336
[paths]
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   337
hg = http://selenic.com/hg
478
f1804f2e7f35 Update of doc/hg.1.txt
Thomas Arendsen Hein <thomas@intevation.de>
parents: 438
diff changeset
   338
tah = http://hg.intevation.org/mercurial-tah/
181
038e4d8602bd updated for .hgpaths and http/old-http protocol name change
jake@edge2.net
parents: 177
diff changeset
   339
321
73b8a8a059ec Transparent proxy support
mpm@selenic.com
parents: 196
diff changeset
   340
NON_TRANSPARENT PROXY SUPPORT
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   341
-----------------------------
321
73b8a8a059ec Transparent proxy support
mpm@selenic.com
parents: 196
diff changeset
   342
438
b38deaf7873e Update docs
mpm@selenic.com
parents: 330
diff changeset
   343
    To access a Mercurial repository through a proxy,
321
73b8a8a059ec Transparent proxy support
mpm@selenic.com
parents: 196
diff changeset
   344
    create a file $HOME/.hgrc in the following format:
73b8a8a059ec Transparent proxy support
mpm@selenic.com
parents: 196
diff changeset
   345
73b8a8a059ec Transparent proxy support
mpm@selenic.com
parents: 196
diff changeset
   346
[http_proxy]
73b8a8a059ec Transparent proxy support
mpm@selenic.com
parents: 196
diff changeset
   347
host=myproxy:8080
73b8a8a059ec Transparent proxy support
mpm@selenic.com
parents: 196
diff changeset
   348
user=<username>
73b8a8a059ec Transparent proxy support
mpm@selenic.com
parents: 196
diff changeset
   349
passwd=<password>
73b8a8a059ec Transparent proxy support
mpm@selenic.com
parents: 196
diff changeset
   350
no=<localhost1>,<localhost2>,<localhost3>,...
73b8a8a059ec Transparent proxy support
mpm@selenic.com
parents: 196
diff changeset
   351
73b8a8a059ec Transparent proxy support
mpm@selenic.com
parents: 196
diff changeset
   352
    "user","passwd" fields are used for authenticating proxies,
73b8a8a059ec Transparent proxy support
mpm@selenic.com
parents: 196
diff changeset
   353
    "no" is a comma-separated list of local host names
73b8a8a059ec Transparent proxy support
mpm@selenic.com
parents: 196
diff changeset
   354
    for which proxy must be bypassed.
73b8a8a059ec Transparent proxy support
mpm@selenic.com
parents: 196
diff changeset
   355
177
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   356
BUGS
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   357
----
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   358
Probably lots, please post them to the mailing list (See Resources below)
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   359
when you find them.
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   360
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   361
AUTHOR
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   362
------
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   363
Written by Matt Mackall <mpm@selenic.com>
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   364
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   365
RESOURCES
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   366
---------
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   367
http://selenic.com/mercurial[Main Web Site]
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   368
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   369
http://selenic.com/hg[Source code repository]
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   370
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   371
http://selenic.com/mailman/listinfo/mercurial[Mailing list]
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   372
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   373
COPYING
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   374
-------
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   375
Copyright (C) 2005 Matt Mackall.
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   376
Free use of this software is granted under the terms of the GNU General
91055f795d88 adding doc directory and files
jake@edge2.net
parents:
diff changeset
   377
Public License (GPL).