doc/hg.1.txt
branchstable
changeset 19466 3289080e57cd
parent 19412 de269e18d09b
parent 19465 004f965630d9
child 19467 1afe5d3939db
equal deleted inserted replaced
19412:de269e18d09b 19466:3289080e57cd
     1 ====
       
     2  hg
       
     3 ====
       
     4 
       
     5 ---------------------------------------
       
     6 Mercurial source code management system
       
     7 ---------------------------------------
       
     8 
       
     9 :Author:         Matt Mackall <mpm@selenic.com>
       
    10 :Organization:   Mercurial
       
    11 :Manual section: 1
       
    12 :Manual group:   Mercurial Manual
       
    13 
       
    14 .. contents::
       
    15    :backlinks: top
       
    16    :class: htmlonly
       
    17    :depth: 1
       
    18 
       
    19 
       
    20 Synopsis
       
    21 """"""""
       
    22 **hg** *command* [*option*]... [*argument*]...
       
    23 
       
    24 Description
       
    25 """""""""""
       
    26 The **hg** command provides a command line interface to the Mercurial
       
    27 system.
       
    28 
       
    29 Command Elements
       
    30 """"""""""""""""
       
    31 
       
    32 files...
       
    33     indicates one or more filename or relative path filenames; see
       
    34     `File Name Patterns`_ for information on pattern matching
       
    35 
       
    36 path
       
    37     indicates a path on the local machine
       
    38 
       
    39 revision
       
    40     indicates a changeset which can be specified as a changeset
       
    41     revision number, a tag, or a unique substring of the changeset
       
    42     hash value
       
    43 
       
    44 repository path
       
    45     either the pathname of a local repository or the URI of a remote
       
    46     repository.
       
    47 
       
    48 .. include:: hg.1.gendoc.txt
       
    49 
       
    50 Files
       
    51 """""
       
    52 
       
    53 ``/etc/mercurial/hgrc``, ``$HOME/.hgrc``, ``.hg/hgrc``
       
    54     This file contains defaults and configuration. Values in
       
    55     ``.hg/hgrc`` override those in ``$HOME/.hgrc``, and these override
       
    56     settings made in the global ``/etc/mercurial/hgrc`` configuration.
       
    57     See |hgrc(5)|_ for details of the contents and format of these
       
    58     files.
       
    59 
       
    60 ``.hgignore``
       
    61     This file contains regular expressions (one per line) that
       
    62     describe file names that should be ignored by **hg**. For details,
       
    63     see |hgignore(5)|_.
       
    64 
       
    65 ``.hgsub``
       
    66     This file defines the locations of all subrepositories, and
       
    67     tells where the subrepository checkouts came from. For details, see
       
    68     :hg:`help subrepos`.
       
    69 
       
    70 ``.hgsubstate``
       
    71     This file is where Mercurial stores all nested repository states. *NB: This
       
    72     file should not be edited manually.*
       
    73 
       
    74 ``.hgtags``
       
    75     This file contains changeset hash values and text tag names (one
       
    76     of each separated by spaces) that correspond to tagged versions of
       
    77     the repository contents. The file content is encoded using UTF-8.
       
    78 
       
    79 ``.hg/last-message.txt``
       
    80     This file is used by :hg:`commit` to store a backup of the commit message
       
    81     in case the commit fails.
       
    82 
       
    83 ``.hg/localtags``
       
    84     This file can be used to define local tags which are not shared among
       
    85     repositories. The file format is the same as for ``.hgtags``, but it is
       
    86     encoded using the local system encoding.
       
    87 
       
    88 Some commands (e.g. revert) produce backup files ending in ``.orig``,
       
    89 if the ``.orig`` file already exists and is not tracked by Mercurial,
       
    90 it will be overwritten.
       
    91 
       
    92 Bugs
       
    93 """"
       
    94 Probably lots, please post them to the mailing list (see Resources_
       
    95 below) when you find them.
       
    96 
       
    97 See Also
       
    98 """"""""
       
    99 |hgignore(5)|_, |hgrc(5)|_
       
   100 
       
   101 Author
       
   102 """"""
       
   103 Written by Matt Mackall <mpm@selenic.com>
       
   104 
       
   105 Resources
       
   106 """""""""
       
   107 Main Web Site: http://mercurial.selenic.com/
       
   108 
       
   109 Source code repository: http://selenic.com/hg
       
   110 
       
   111 Mailing list: http://selenic.com/mailman/listinfo/mercurial
       
   112 
       
   113 Copying
       
   114 """""""
       
   115 Copyright (C) 2005-2012 Matt Mackall.
       
   116 Free use of this software is granted under the terms of the GNU General
       
   117 Public License version 2 or any later version.
       
   118 
       
   119 .. include:: common.txt