mercurial-scm/hg-stable: mercurial/help/config.txt annotate

annotate mercurial/help/config.txt @ 16392:ee3f423df1b4

dispatch: add support for statprof as a profiler This can be selected using the config variable profiling.type or the environment variable HGPROF ("ls" for the default, "stat" for statprof). The only tuneable is the frequency, profiling.freq, which defaults to 1000 Hz. If statprof is not available, a warning is printed.

author	Bryan O'Sullivan <bryano@fb.com>
date	Mon, 09 Apr 2012 13:48:45 -0700
parents	9cf7c9d529d0
children	7416ce2c7887

rev	line source
14460 d5f616132c10 doc: improve merge between hgrc.5 and config help topic Martin Geisler <mg@lazybytes.net> parents: 14458 diff changeset	1 The Mercurial system uses a set of configuration files to control
d5f616132c10 doc: improve merge between hgrc.5 and config help topic Martin Geisler <mg@lazybytes.net> parents: 14458 diff changeset	2 aspects of its behavior.
9785 b52f0f221325 help: add "hg help config" topic Martin Geisler <mg@lazybytes.net> parents: diff changeset	3
14460 d5f616132c10 doc: improve merge between hgrc.5 and config help topic Martin Geisler <mg@lazybytes.net> parents: 14458 diff changeset	4 The configuration files use a simple ini-file format. A configuration
d5f616132c10 doc: improve merge between hgrc.5 and config help topic Martin Geisler <mg@lazybytes.net> parents: 14458 diff changeset	5 file consists of sections, led by a ``[section]`` header and followed
d5f616132c10 doc: improve merge between hgrc.5 and config help topic Martin Geisler <mg@lazybytes.net> parents: 14458 diff changeset	6 by ``name = value`` entries::
9785 b52f0f221325 help: add "hg help config" topic Martin Geisler <mg@lazybytes.net> parents: diff changeset	7
14460 d5f616132c10 doc: improve merge between hgrc.5 and config help topic Martin Geisler <mg@lazybytes.net> parents: 14458 diff changeset	8 [ui]
d5f616132c10 doc: improve merge between hgrc.5 and config help topic Martin Geisler <mg@lazybytes.net> parents: 14458 diff changeset	9 username = Firstname Lastname <firstname.lastname@example.net>
d5f616132c10 doc: improve merge between hgrc.5 and config help topic Martin Geisler <mg@lazybytes.net> parents: 14458 diff changeset	10 verbose = True
9785 b52f0f221325 help: add "hg help config" topic Martin Geisler <mg@lazybytes.net> parents: diff changeset	11
14460 d5f616132c10 doc: improve merge between hgrc.5 and config help topic Martin Geisler <mg@lazybytes.net> parents: 14458 diff changeset	12 The above entries will be referred to as ``ui.username`` and
d5f616132c10 doc: improve merge between hgrc.5 and config help topic Martin Geisler <mg@lazybytes.net> parents: 14458 diff changeset	13 ``ui.verbose``, respectively. See the Syntax section below.
9785 b52f0f221325 help: add "hg help config" topic Martin Geisler <mg@lazybytes.net> parents: diff changeset	14
14460 d5f616132c10 doc: improve merge between hgrc.5 and config help topic Martin Geisler <mg@lazybytes.net> parents: 14458 diff changeset	15 Files
d5f616132c10 doc: improve merge between hgrc.5 and config help topic Martin Geisler <mg@lazybytes.net> parents: 14458 diff changeset	16 -----
9785 b52f0f221325 help: add "hg help config" topic Martin Geisler <mg@lazybytes.net> parents: diff changeset	17
14460 d5f616132c10 doc: improve merge between hgrc.5 and config help topic Martin Geisler <mg@lazybytes.net> parents: 14458 diff changeset	18 Mercurial reads configuration data from several files, if they exist.
13955 86b5cc1e8be8 help config: explain that config files do not exist by default Martin Geisler <mg@lazybytes.net> parents: 11408 diff changeset	19 These files do not exist by default and you will have to create the
86b5cc1e8be8 help config: explain that config files do not exist by default Martin Geisler <mg@lazybytes.net> parents: 11408 diff changeset	20 appropriate configuration files yourself: global configuration like
86b5cc1e8be8 help config: explain that config files do not exist by default Martin Geisler <mg@lazybytes.net> parents: 11408 diff changeset	21 the username setting is typically put into
86b5cc1e8be8 help config: explain that config files do not exist by default Martin Geisler <mg@lazybytes.net> parents: 11408 diff changeset	22 ``%USERPROFILE%\mercurial.ini`` or ``$HOME/.hgrc`` and local
86b5cc1e8be8 help config: explain that config files do not exist by default Martin Geisler <mg@lazybytes.net> parents: 11408 diff changeset	23 configuration is put into the per-repository ``<repo>/.hg/hgrc`` file.
86b5cc1e8be8 help config: explain that config files do not exist by default Martin Geisler <mg@lazybytes.net> parents: 11408 diff changeset	24
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	25 The names of these files depend on the system on which Mercurial is
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	26 installed. ``*.rc`` files from a single directory are read in
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	27 alphabetical order, later ones overriding earlier ones. Where multiple
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	28 paths are given below, settings from earlier paths override later
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	29 ones.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	30
16383 f5dd179bfa4a plan9: initial support for plan 9 from bell labs Steven Stallion <sstallion@gmail.com> parents: 16361 diff changeset	31 \| (All) ``<repo>/.hg/hgrc``
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	32
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	33 Per-repository configuration options that only apply in a
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	34 particular repository. This file is not version-controlled, and
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	35 will not get transferred during a "clone" operation. Options in
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	36 this file override options in all other configuration files. On
16383 f5dd179bfa4a plan9: initial support for plan 9 from bell labs Steven Stallion <sstallion@gmail.com> parents: 16361 diff changeset	37 Plan 9 and Unix, most of this file will be ignored if it doesn't
f5dd179bfa4a plan9: initial support for plan 9 from bell labs Steven Stallion <sstallion@gmail.com> parents: 16361 diff changeset	38 belong to a trusted user or to a trusted group. See the documentation
f5dd179bfa4a plan9: initial support for plan 9 from bell labs Steven Stallion <sstallion@gmail.com> parents: 16361 diff changeset	39 for the ``[trusted]`` section below for more details.
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	40
16383 f5dd179bfa4a plan9: initial support for plan 9 from bell labs Steven Stallion <sstallion@gmail.com> parents: 16361 diff changeset	41 \| (Plan 9) ``$home/lib/hgrc``
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	42 \| (Unix) ``$HOME/.hgrc``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	43 \| (Windows) ``%USERPROFILE%\.hgrc``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	44 \| (Windows) ``%USERPROFILE%\Mercurial.ini``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	45 \| (Windows) ``%HOME%\.hgrc``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	46 \| (Windows) ``%HOME%\Mercurial.ini``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	47
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	48 Per-user configuration file(s), for the user running Mercurial. On
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	49 Windows 9x, ``%HOME%`` is replaced by ``%APPDATA%``. Options in these
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	50 files apply to all Mercurial commands executed by this user in any
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	51 directory. Options in these files override per-system and per-installation
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	52 options.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	53
16383 f5dd179bfa4a plan9: initial support for plan 9 from bell labs Steven Stallion <sstallion@gmail.com> parents: 16361 diff changeset	54 \| (Plan 9) ``/lib/mercurial/hgrc``
f5dd179bfa4a plan9: initial support for plan 9 from bell labs Steven Stallion <sstallion@gmail.com> parents: 16361 diff changeset	55 \| (Plan 9) ``/lib/mercurial/hgrc.d/*.rc``
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	56 \| (Unix) ``/etc/mercurial/hgrc``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	57 \| (Unix) ``/etc/mercurial/hgrc.d/*.rc``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	58
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	59 Per-system configuration files, for the system on which Mercurial
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	60 is running. Options in these files apply to all Mercurial commands
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	61 executed by any user in any directory. Options in these files
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	62 override per-installation options.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	63
16383 f5dd179bfa4a plan9: initial support for plan 9 from bell labs Steven Stallion <sstallion@gmail.com> parents: 16361 diff changeset	64 \| (Plan 9) ``<install-root>/lib/mercurial/hgrc``
f5dd179bfa4a plan9: initial support for plan 9 from bell labs Steven Stallion <sstallion@gmail.com> parents: 16361 diff changeset	65 \| (Plan 9) ``<install-root>/lib/mercurial/hgrc.d/*.rc``
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	66 \| (Unix) ``<install-root>/etc/mercurial/hgrc``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	67 \| (Unix) ``<install-root>/etc/mercurial/hgrc.d/*.rc``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	68
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	69 Per-installation configuration files, searched for in the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	70 directory where Mercurial is installed. ``<install-root>`` is the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	71 parent directory of the hg executable (or symlink) being run. For
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	72 example, if installed in ``/shared/tools/bin/hg``, Mercurial will look
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	73 in ``/shared/tools/etc/mercurial/hgrc``. Options in these files apply
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	74 to all Mercurial commands executed by any user in any directory.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	75
14460 d5f616132c10 doc: improve merge between hgrc.5 and config help topic Martin Geisler <mg@lazybytes.net> parents: 14458 diff changeset	76 \| (Windows) ``<install-dir>\Mercurial.ini`` or
d5f616132c10 doc: improve merge between hgrc.5 and config help topic Martin Geisler <mg@lazybytes.net> parents: 14458 diff changeset	77 \| (Windows) ``<install-dir>\hgrc.d\.rc`` or*
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	78 \| (Windows) ``HKEY_LOCAL_MACHINE\SOFTWARE\Mercurial``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	79
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	80 Per-installation/system configuration files, for the system on
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	81 which Mercurial is running. Options in these files apply to all
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	82 Mercurial commands executed by any user in any directory. Registry
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	83 keys contain PATH-like strings, every part of which must reference
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	84 a ``Mercurial.ini`` file or be a directory where ``*.rc`` files will
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	85 be read. Mercurial checks each of these locations in the specified
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	86 order until one or more configuration files are detected. If the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	87 pywin32 extensions are not installed, Mercurial will only look for
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	88 site-wide configuration in ``C:\Mercurial\Mercurial.ini``.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	89
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	90 Syntax
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	91 ------
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	92
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	93 A configuration file consists of sections, led by a ``[section]`` header
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	94 and followed by ``name = value`` entries (sometimes called
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	95 ``configuration keys``)::
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	96
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	97 [spam]
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	98 eggs=ham
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	99 green=
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	100 eggs
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	101
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	102 Each line contains one entry. If the lines that follow are indented,
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	103 they are treated as continuations of that entry. Leading whitespace is
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	104 removed from values. Empty lines are skipped. Lines beginning with
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	105 ``#`` or ``;`` are ignored and may be used to provide comments.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	106
14651 e9e4e9ab62bd help/config: fix 'Mercurial' casing Wagner Bruna <wbruna@softwareexpress.com.br> parents: 14460 diff changeset	107 Configuration keys can be set multiple times, in which case Mercurial
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	108 will use the value that was configured last. As an example::
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	109
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	110 [spam]
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	111 eggs=large
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	112 ham=serrano
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	113 eggs=small
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	114
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	115 This would set the configuration key named ``eggs`` to ``small``.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	116
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	117 It is also possible to define a section multiple times. A section can
14652 73cb35f6fd78 help/config: do not refer to config files as hgrc files Wagner Bruna <wbruna@softwareexpress.com.br> parents: 14651 diff changeset	118 be redefined on the same and/or on different configuration files. For
73cb35f6fd78 help/config: do not refer to config files as hgrc files Wagner Bruna <wbruna@softwareexpress.com.br> parents: 14651 diff changeset	119 example::
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	120
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	121 [foo]
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	122 eggs=large
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	123 ham=serrano
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	124 eggs=small
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	125
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	126 [bar]
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	127 eggs=ham
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	128 green=
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	129 eggs
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	130
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	131 [foo]
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	132 ham=prosciutto
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	133 eggs=medium
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	134 bread=toasted
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	135
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	136 This would set the ``eggs``, ``ham``, and ``bread`` configuration keys
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	137 of the ``foo`` section to ``medium``, ``prosciutto``, and ``toasted``,
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	138 respectively. As you can see there only thing that matters is the last
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	139 value that was set for each of the configuration keys.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	140
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	141 If a configuration key is set multiple times in different
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	142 configuration files the final value will depend on the order in which
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	143 the different configuration files are read, with settings from earlier
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	144 paths overriding later ones as described on the ``Files`` section
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	145 above.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	146
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	147 A line of the form ``%include file`` will include ``file`` into the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	148 current configuration file. The inclusion is recursive, which means
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	149 that included files can include other files. Filenames are relative to
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	150 the configuration file in which the ``%include`` directive is found.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	151 Environment variables and ``~user`` constructs are expanded in
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	152 ``file``. This lets you do something like::
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	153
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	154 %include ~/.hgrc.d/$HOST.rc
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	155
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	156 to include a different configuration file on each computer you use.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	157
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	158 A line with ``%unset name`` will remove ``name`` from the current
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	159 section, if it has been set previously.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	160
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	161 The values are either free-form text strings, lists of text strings,
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	162 or Boolean values. Boolean values can be set to true using any of "1",
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	163 "yes", "true", or "on" and to false using "0", "no", "false", or "off"
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	164 (all case insensitive).
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	165
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	166 List values are separated by whitespace or comma, except when values are
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	167 placed in double quotation marks::
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	168
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	169 allow_read = "John Doe, PhD", brian, betty
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	170
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	171 Quotation marks can be escaped by prefixing them with a backslash. Only
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	172 quotation marks at the beginning of a word is counted as a quotation
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	173 (e.g., ``foo"bar baz`` is the list of ``foo"bar`` and ``baz``).
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	174
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	175 Sections
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	176 --------
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	177
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	178 This section describes the different sections that may appear in a
14652 73cb35f6fd78 help/config: do not refer to config files as hgrc files Wagner Bruna <wbruna@softwareexpress.com.br> parents: 14651 diff changeset	179 Mercurial configuration file, the purpose of each section, its possible
73cb35f6fd78 help/config: do not refer to config files as hgrc files Wagner Bruna <wbruna@softwareexpress.com.br> parents: 14651 diff changeset	180 keys, and their possible values.
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	181
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	182 ``alias``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	183 """""""""
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	184
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	185 Defines command aliases.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	186 Aliases allow you to define your own commands in terms of other
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	187 commands (or aliases), optionally including arguments. Positional
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	188 arguments in the form of ``$1``, ``$2``, etc in the alias definition
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	189 are expanded by Mercurial before execution. Positional arguments not
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	190 already used by ``$N`` in the definition are put at the end of the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	191 command to be executed.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	192
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	193 Alias definitions consist of lines of the form::
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	194
14653 6f96c7a908bd help/config: fix small typo Wagner Bruna <wbruna@softwareexpress.com.br> parents: 14652 diff changeset	195 <alias> = <command> [<argument>]...
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	196
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	197 For example, this definition::
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	198
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	199 latest = log --limit 5
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	200
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	201 creates a new command ``latest`` that shows only the five most recent
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	202 changesets. You can define subsequent aliases using earlier ones::
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	203
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	204 stable5 = latest -b stable
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	205
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	206 .. note:: It is possible to create aliases with the same names as
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	207 existing commands, which will then override the original
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	208 definitions. This is almost always a bad idea!
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	209
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	210 An alias can start with an exclamation point (``!``) to make it a
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	211 shell alias. A shell alias is executed with the shell and will let you
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	212 run arbitrary commands. As an example, ::
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	213
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	214 echo = !echo
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	215
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	216 will let you do ``hg echo foo`` to have ``foo`` printed in your
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	217 terminal. A better example might be::
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	218
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	219 purge = !$HG status --no-status --unknown -0 \| xargs -0 rm
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	220
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	221 which will make ``hg purge`` delete all unknown files in the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	222 repository in the same manner as the purge extension.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	223
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	224 Shell aliases are executed in an environment where ``$HG`` expand to
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	225 the path of the Mercurial that was used to execute the alias. This is
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	226 useful when you want to call further Mercurial commands in a shell
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	227 alias, as was done above for the purge alias. In addition,
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	228 ``$HG_ARGS`` expand to the arguments given to Mercurial. In the ``hg
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	229 echo foo`` call above, ``$HG_ARGS`` would expand to ``echo foo``.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	230
14891 62122c1c830b alias: note interaction of shell aliases with early opts in help Matt Mackall <mpm@selenic.com> parents: 14691 diff changeset	231 .. note:: Some global configuration options such as ``-R`` are
62122c1c830b alias: note interaction of shell aliases with early opts in help Matt Mackall <mpm@selenic.com> parents: 14691 diff changeset	232 processed before shell aliases and will thus not be passed to
62122c1c830b alias: note interaction of shell aliases with early opts in help Matt Mackall <mpm@selenic.com> parents: 14691 diff changeset	233 aliases.
62122c1c830b alias: note interaction of shell aliases with early opts in help Matt Mackall <mpm@selenic.com> parents: 14691 diff changeset	234
15528 a84698badf0b annotate: support diff whitespace filtering flags (issue3030) Patrick Mezard <pmezard@gmail.com> parents: 15321 diff changeset	235
a84698badf0b annotate: support diff whitespace filtering flags (issue3030) Patrick Mezard <pmezard@gmail.com> parents: 15321 diff changeset	236 ``annotate``
15612 6f2eee68f6a5 help: properly underline annotate config heading Christian Ebert <blacktrash@gmx.net> parents: 15528 diff changeset	237 """"""""""""
15528 a84698badf0b annotate: support diff whitespace filtering flags (issue3030) Patrick Mezard <pmezard@gmail.com> parents: 15321 diff changeset	238
a84698badf0b annotate: support diff whitespace filtering flags (issue3030) Patrick Mezard <pmezard@gmail.com> parents: 15321 diff changeset	239 Settings used when displaying file annotations. All values are
a84698badf0b annotate: support diff whitespace filtering flags (issue3030) Patrick Mezard <pmezard@gmail.com> parents: 15321 diff changeset	240 Booleans and default to False. See ``diff`` section for related
a84698badf0b annotate: support diff whitespace filtering flags (issue3030) Patrick Mezard <pmezard@gmail.com> parents: 15321 diff changeset	241 options for the diff command.
a84698badf0b annotate: support diff whitespace filtering flags (issue3030) Patrick Mezard <pmezard@gmail.com> parents: 15321 diff changeset	242
a84698badf0b annotate: support diff whitespace filtering flags (issue3030) Patrick Mezard <pmezard@gmail.com> parents: 15321 diff changeset	243 ``ignorews``
a84698badf0b annotate: support diff whitespace filtering flags (issue3030) Patrick Mezard <pmezard@gmail.com> parents: 15321 diff changeset	244 Ignore white space when comparing lines.
a84698badf0b annotate: support diff whitespace filtering flags (issue3030) Patrick Mezard <pmezard@gmail.com> parents: 15321 diff changeset	245
a84698badf0b annotate: support diff whitespace filtering flags (issue3030) Patrick Mezard <pmezard@gmail.com> parents: 15321 diff changeset	246 ``ignorewsamount``
a84698badf0b annotate: support diff whitespace filtering flags (issue3030) Patrick Mezard <pmezard@gmail.com> parents: 15321 diff changeset	247 Ignore changes in the amount of white space.
a84698badf0b annotate: support diff whitespace filtering flags (issue3030) Patrick Mezard <pmezard@gmail.com> parents: 15321 diff changeset	248
a84698badf0b annotate: support diff whitespace filtering flags (issue3030) Patrick Mezard <pmezard@gmail.com> parents: 15321 diff changeset	249 ``ignoreblanklines``
a84698badf0b annotate: support diff whitespace filtering flags (issue3030) Patrick Mezard <pmezard@gmail.com> parents: 15321 diff changeset	250 Ignore changes whose lines are all blank.
a84698badf0b annotate: support diff whitespace filtering flags (issue3030) Patrick Mezard <pmezard@gmail.com> parents: 15321 diff changeset	251
a84698badf0b annotate: support diff whitespace filtering flags (issue3030) Patrick Mezard <pmezard@gmail.com> parents: 15321 diff changeset	252
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	253 ``auth``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	254 """"""""
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	255
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	256 Authentication credentials for HTTP authentication. This section
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	257 allows you to store usernames and passwords for use when logging
14654 e21fd445c297 help/config: quote config section names consistently Wagner Bruna <wbruna@softwareexpress.com.br> parents: 14653 diff changeset	258 into HTTP servers. See the ``[web]`` configuration section if
e21fd445c297 help/config: quote config section names consistently Wagner Bruna <wbruna@softwareexpress.com.br> parents: 14653 diff changeset	259 you want to configure who can login to your HTTP server.
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	260
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	261 Each line has the following format::
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	262
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	263 <name>.<argument> = <value>
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	264
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	265 where ``<name>`` is used to group arguments into authentication
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	266 entries. Example::
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	267
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	268 foo.prefix = hg.intevation.org/mercurial
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	269 foo.username = foo
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	270 foo.password = bar
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	271 foo.schemes = http https
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	272
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	273 bar.prefix = secure.example.org
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	274 bar.key = path/to/file.key
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	275 bar.cert = path/to/file.cert
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	276 bar.schemes = https
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	277
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	278 Supported arguments:
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	279
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	280 ``prefix``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	281 Either ``*`` or a URI prefix with or without the scheme part.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	282 The authentication entry with the longest matching prefix is used
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	283 (where ``*`` matches everything and counts as a match of length
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	284 1). If the prefix doesn't include a scheme, the match is performed
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	285 against the URI with its scheme stripped as well, and the schemes
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	286 argument, q.v., is then subsequently consulted.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	287
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	288 ``username``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	289 Optional. Username to authenticate with. If not given, and the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	290 remote site requires basic or digest authentication, the user will
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	291 be prompted for it. Environment variables are expanded in the
15005 4a43e23b8c55 hgweb: do not ignore [auth] if url has a username (issue2822) Patrick Mezard <pmezard@gmail.com> parents: 15004 diff changeset	292 username letting you do ``foo.username = $USER``. If the URI
4a43e23b8c55 hgweb: do not ignore [auth] if url has a username (issue2822) Patrick Mezard <pmezard@gmail.com> parents: 15004 diff changeset	293 includes a username, only ``[auth]`` entries with a matching
4a43e23b8c55 hgweb: do not ignore [auth] if url has a username (issue2822) Patrick Mezard <pmezard@gmail.com> parents: 15004 diff changeset	294 username or without a username will be considered.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	295
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	296 ``password``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	297 Optional. Password to authenticate with. If not given, and the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	298 remote site requires basic or digest authentication, the user
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	299 will be prompted for it.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	300
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	301 ``key``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	302 Optional. PEM encoded client certificate key file. Environment
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	303 variables are expanded in the filename.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	304
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	305 ``cert``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	306 Optional. PEM encoded client certificate chain file. Environment
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	307 variables are expanded in the filename.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	308
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	309 ``schemes``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	310 Optional. Space separated list of URI schemes to use this
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	311 authentication entry with. Only used if the prefix doesn't include
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	312 a scheme. Supported schemes are http and https. They will match
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	313 static-http and static-https respectively, as well.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	314 Default: https.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	315
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	316 If no suitable authentication entry is found, the user is prompted
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	317 for credentials as usual if required by the remote.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	318
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	319
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	320 ``decode/encode``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	321 """""""""""""""""
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	322
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	323 Filters for transforming files on checkout/checkin. This would
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	324 typically be used for newline processing or other
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	325 localization/canonicalization of files.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	326
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	327 Filters consist of a filter pattern followed by a filter command.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	328 Filter patterns are globs by default, rooted at the repository root.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	329 For example, to match any file ending in ``.txt`` in the root
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	330 directory only, use the pattern ``*.txt``. To match any file ending
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	331 in ``.c`` anywhere in the repository, use the pattern ``**.c``.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	332 For each file only the first matching filter applies.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	333
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	334 The filter command can start with a specifier, either ``pipe:`` or
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	335 ``tempfile:``. If no specifier is given, ``pipe:`` is used by default.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	336
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	337 A ``pipe:`` command must accept data on stdin and return the transformed
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	338 data on stdout.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	339
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	340 Pipe example::
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	341
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	342 [encode]
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	343 # uncompress gzip files on checkin to improve delta compression
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	344 # note: not necessarily a good idea, just an example
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	345 *.gz = pipe: gunzip
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	346
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	347 [decode]
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	348 # recompress gzip files when writing them to the working dir (we
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	349 # can safely omit "pipe:", because it's the default)
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	350 *.gz = gzip
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	351
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	352 A ``tempfile:`` command is a template. The string ``INFILE`` is replaced
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	353 with the name of a temporary file that contains the data to be
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	354 filtered by the command. The string ``OUTFILE`` is replaced with the name
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	355 of an empty temporary file, where the filtered data must be written by
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	356 the command.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	357
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	358 .. note:: The tempfile mechanism is recommended for Windows systems,
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	359 where the standard shell I/O redirection operators often have
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	360 strange effects and may corrupt the contents of your files.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	361
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	362 This filter mechanism is used internally by the ``eol`` extension to
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	363 translate line ending characters between Windows (CRLF) and Unix (LF)
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	364 format. We suggest you use the ``eol`` extension for convenience.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	365
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	366
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	367 ``defaults``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	368 """"""""""""
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	369
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	370 (defaults are deprecated. Don't use them. Use aliases instead)
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	371
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	372 Use the ``[defaults]`` section to define command defaults, i.e. the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	373 default options/arguments to pass to the specified commands.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	374
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	375 The following example makes :hg:`log` run in verbose mode, and
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	376 :hg:`status` show only the modified files, by default::
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	377
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	378 [defaults]
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	379 log = -v
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	380 status = -m
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	381
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	382 The actual commands, instead of their aliases, must be used when
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	383 defining command defaults. The command defaults will also be applied
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	384 to the aliases of the commands defined.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	385
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	386
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	387 ``diff``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	388 """"""""
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	389
15528 a84698badf0b annotate: support diff whitespace filtering flags (issue3030) Patrick Mezard <pmezard@gmail.com> parents: 15321 diff changeset	390 Settings used when displaying diffs. Everything except for ``unified``
a84698badf0b annotate: support diff whitespace filtering flags (issue3030) Patrick Mezard <pmezard@gmail.com> parents: 15321 diff changeset	391 is a Boolean and defaults to False. See ``annotate`` section for
a84698badf0b annotate: support diff whitespace filtering flags (issue3030) Patrick Mezard <pmezard@gmail.com> parents: 15321 diff changeset	392 related options for the annotate command.
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	393
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	394 ``git``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	395 Use git extended diff format.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	396
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	397 ``nodates``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	398 Don't include dates in diff headers.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	399
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	400 ``showfunc``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	401 Show which function each change is in.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	402
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	403 ``ignorews``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	404 Ignore white space when comparing lines.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	405
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	406 ``ignorewsamount``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	407 Ignore changes in the amount of white space.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	408
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	409 ``ignoreblanklines``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	410 Ignore changes whose lines are all blank.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	411
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	412 ``unified``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	413 Number of lines of context to show.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	414
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	415 ``email``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	416 """""""""
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	417
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	418 Settings for extensions that send email messages.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	419
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	420 ``from``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	421 Optional. Email address to use in "From" header and SMTP envelope
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	422 of outgoing messages.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	423
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	424 ``to``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	425 Optional. Comma-separated list of recipients' email addresses.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	426
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	427 ``cc``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	428 Optional. Comma-separated list of carbon copy recipients'
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	429 email addresses.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	430
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	431 ``bcc``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	432 Optional. Comma-separated list of blind carbon copy recipients'
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	433 email addresses.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	434
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	435 ``method``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	436 Optional. Method to use to send email messages. If value is ``smtp``
14654 e21fd445c297 help/config: quote config section names consistently Wagner Bruna <wbruna@softwareexpress.com.br> parents: 14653 diff changeset	437 (default), use SMTP (see the ``[smtp]`` section for configuration).
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	438 Otherwise, use as name of program to run that acts like sendmail
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	439 (takes ``-f`` option for sender, list of recipients on command line,
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	440 message on stdin). Normally, setting this to ``sendmail`` or
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	441 ``/usr/sbin/sendmail`` is enough to use sendmail to send messages.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	442
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	443 ``charsets``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	444 Optional. Comma-separated list of character sets considered
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	445 convenient for recipients. Addresses, headers, and parts not
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	446 containing patches of outgoing messages will be encoded in the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	447 first character set to which conversion from local encoding
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	448 (``$HGENCODING``, ``ui.fallbackencoding``) succeeds. If correct
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	449 conversion fails, the text in question is sent as is. Defaults to
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	450 empty (explicit) list.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	451
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	452 Order of outgoing email character sets:
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	453
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	454 1. ``us-ascii``: always first, regardless of settings
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	455 2. ``email.charsets``: in order given by user
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	456 3. ``ui.fallbackencoding``: if not in email.charsets
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	457 4. ``$HGENCODING``: if not in email.charsets
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	458 5. ``utf-8``: always last, regardless of settings
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	459
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	460 Email example::
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	461
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	462 [email]
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	463 from = Joseph User <joe.user@example.com>
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	464 method = /usr/sbin/sendmail
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	465 # charsets for western Europeans
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	466 # us-ascii, utf-8 omitted, as they are tried first and last
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	467 charsets = iso-8859-1, iso-8859-15, windows-1252
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	468
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	469
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	470 ``extensions``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	471 """"""""""""""
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	472
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	473 Mercurial has an extension mechanism for adding new features. To
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	474 enable an extension, create an entry for it in this section.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	475
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	476 If you know that the extension is already in Python's search path,
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	477 you can give the name of the module, followed by ``=``, with nothing
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	478 after the ``=``.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	479
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	480 Otherwise, give a name that you choose, followed by ``=``, followed by
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	481 the path to the ``.py`` file (including the file name extension) that
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	482 defines the extension.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	483
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	484 To explicitly disable an extension that is enabled in an hgrc of
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	485 broader scope, prepend its path with ``!``, as in ``foo = !/ext/path``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	486 or ``foo = !`` when path is not supplied.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	487
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	488 Example for ``~/.hgrc``::
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	489
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	490 [extensions]
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	491 # (the mq extension will get loaded from Mercurial's path)
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	492 mq =
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	493 # (this extension will get loaded from the file specified)
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	494 myfeature = ~/.hgext/myfeature.py
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	495
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	496
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	497 ``format``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	498 """"""""""
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	499
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	500 ``usestore``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	501 Enable or disable the "store" repository format which improves
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	502 compatibility with systems that fold case or otherwise mangle
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	503 filenames. Enabled by default. Disabling this option will allow
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	504 you to store longer filenames in some situations at the expense of
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	505 compatibility and ensures that the on-disk format of newly created
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	506 repositories will be compatible with Mercurial before version 0.9.4.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	507
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	508 ``usefncache``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	509 Enable or disable the "fncache" repository format which enhances
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	510 the "store" repository format (which has to be enabled to use
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	511 fncache) to allow longer filenames and avoids using Windows
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	512 reserved names, e.g. "nul". Enabled by default. Disabling this
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	513 option ensures that the on-disk format of newly created
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	514 repositories will be compatible with Mercurial before version 1.1.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	515
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	516 ``dotencode``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	517 Enable or disable the "dotencode" repository format which enhances
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	518 the "fncache" repository format (which has to be enabled to use
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	519 dotencode) to avoid issues with filenames starting with ._ on
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	520 Mac OS X and spaces on Windows. Enabled by default. Disabling this
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	521 option ensures that the on-disk format of newly created
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	522 repositories will be compatible with Mercurial before version 1.7.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	523
16129 5e50982c633c graph: in hgrc specify line width for main branch Constantine Linnick <theaspect@gmail.com> parents: 16005 diff changeset	524 ``graph``
5e50982c633c graph: in hgrc specify line width for main branch Constantine Linnick <theaspect@gmail.com> parents: 16005 diff changeset	525 """""""""
5e50982c633c graph: in hgrc specify line width for main branch Constantine Linnick <theaspect@gmail.com> parents: 16005 diff changeset	526
16139 461a59e2765a doc: minor fixes to [graph] section documentation Patrick Mezard <patrick@mezard.eu> parents: 16130 diff changeset	527 Web graph view configuration. This section let you change graph
461a59e2765a doc: minor fixes to [graph] section documentation Patrick Mezard <patrick@mezard.eu> parents: 16130 diff changeset	528 elements display properties by branches, for instance to make the
461a59e2765a doc: minor fixes to [graph] section documentation Patrick Mezard <patrick@mezard.eu> parents: 16130 diff changeset	529 ``default`` branch stand out.
16129 5e50982c633c graph: in hgrc specify line width for main branch Constantine Linnick <theaspect@gmail.com> parents: 16005 diff changeset	530
16139 461a59e2765a doc: minor fixes to [graph] section documentation Patrick Mezard <patrick@mezard.eu> parents: 16130 diff changeset	531 Each line has the following format::
461a59e2765a doc: minor fixes to [graph] section documentation Patrick Mezard <patrick@mezard.eu> parents: 16130 diff changeset	532
461a59e2765a doc: minor fixes to [graph] section documentation Patrick Mezard <patrick@mezard.eu> parents: 16130 diff changeset	533 <branch>.<argument> = <value>
16129 5e50982c633c graph: in hgrc specify line width for main branch Constantine Linnick <theaspect@gmail.com> parents: 16005 diff changeset	534
16139 461a59e2765a doc: minor fixes to [graph] section documentation Patrick Mezard <patrick@mezard.eu> parents: 16130 diff changeset	535 where ``<branch>`` is the name of the branch being
461a59e2765a doc: minor fixes to [graph] section documentation Patrick Mezard <patrick@mezard.eu> parents: 16130 diff changeset	536 customized. Example::
461a59e2765a doc: minor fixes to [graph] section documentation Patrick Mezard <patrick@mezard.eu> parents: 16130 diff changeset	537
461a59e2765a doc: minor fixes to [graph] section documentation Patrick Mezard <patrick@mezard.eu> parents: 16130 diff changeset	538 [graph]
461a59e2765a doc: minor fixes to [graph] section documentation Patrick Mezard <patrick@mezard.eu> parents: 16130 diff changeset	539 # 2px width
461a59e2765a doc: minor fixes to [graph] section documentation Patrick Mezard <patrick@mezard.eu> parents: 16130 diff changeset	540 default.width = 2
461a59e2765a doc: minor fixes to [graph] section documentation Patrick Mezard <patrick@mezard.eu> parents: 16130 diff changeset	541 # red color
461a59e2765a doc: minor fixes to [graph] section documentation Patrick Mezard <patrick@mezard.eu> parents: 16130 diff changeset	542 default.color = FF0000
16129 5e50982c633c graph: in hgrc specify line width for main branch Constantine Linnick <theaspect@gmail.com> parents: 16005 diff changeset	543
5e50982c633c graph: in hgrc specify line width for main branch Constantine Linnick <theaspect@gmail.com> parents: 16005 diff changeset	544 Supported arguments:
5e50982c633c graph: in hgrc specify line width for main branch Constantine Linnick <theaspect@gmail.com> parents: 16005 diff changeset	545
5e50982c633c graph: in hgrc specify line width for main branch Constantine Linnick <theaspect@gmail.com> parents: 16005 diff changeset	546 ``width``
16139 461a59e2765a doc: minor fixes to [graph] section documentation Patrick Mezard <patrick@mezard.eu> parents: 16130 diff changeset	547 Set branch edges width in pixels.
16129 5e50982c633c graph: in hgrc specify line width for main branch Constantine Linnick <theaspect@gmail.com> parents: 16005 diff changeset	548
16130 33f702e52906 graph: in hgrc specify line color for main branch Constantine Linnick <theaspect@gmail.com> parents: 16129 diff changeset	549 ``color``
16139 461a59e2765a doc: minor fixes to [graph] section documentation Patrick Mezard <patrick@mezard.eu> parents: 16130 diff changeset	550 Set branch edges color in hexadecimal RGB notation.
16129 5e50982c633c graph: in hgrc specify line width for main branch Constantine Linnick <theaspect@gmail.com> parents: 16005 diff changeset	551
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	552 ``hooks``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	553 """""""""
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	554
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	555 Commands or Python functions that get automatically executed by
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	556 various actions such as starting or finishing a commit. Multiple
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	557 hooks can be run for the same action by appending a suffix to the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	558 action. Overriding a site-wide hook can be done by changing its
15896 30c34fde40cc hooks: prioritize run order of hooks Matt Zuba <matt.zuba@goodwillaz.org> parents: 15612 diff changeset	559 value or setting it to an empty string. Hooks can be prioritized
30c34fde40cc hooks: prioritize run order of hooks Matt Zuba <matt.zuba@goodwillaz.org> parents: 15612 diff changeset	560 by adding a prefix of ``priority`` to the hook name on a new line
30c34fde40cc hooks: prioritize run order of hooks Matt Zuba <matt.zuba@goodwillaz.org> parents: 15612 diff changeset	561 and setting the priority. The default priority is 0 if
30c34fde40cc hooks: prioritize run order of hooks Matt Zuba <matt.zuba@goodwillaz.org> parents: 15612 diff changeset	562 not specified.
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	563
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	564 Example ``.hg/hgrc``::
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	565
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	566 [hooks]
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	567 # update working directory after adding changesets
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	568 changegroup.update = hg update
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	569 # do not use the site-wide hook
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	570 incoming =
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	571 incoming.email = /my/email/hook
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	572 incoming.autobuild = /my/build/hook
15896 30c34fde40cc hooks: prioritize run order of hooks Matt Zuba <matt.zuba@goodwillaz.org> parents: 15612 diff changeset	573 # force autobuild hook to run before other incoming hooks
30c34fde40cc hooks: prioritize run order of hooks Matt Zuba <matt.zuba@goodwillaz.org> parents: 15612 diff changeset	574 priority.incoming.autobuild = 1
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	575
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	576 Most hooks are run with environment variables set that give useful
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	577 additional information. For each hook below, the environment
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	578 variables it is passed are listed with names of the form ``$HG_foo``.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	579
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	580 ``changegroup``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	581 Run after a changegroup has been added via push, pull or unbundle.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	582 ID of the first new changeset is in ``$HG_NODE``. URL from which
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	583 changes came is in ``$HG_URL``.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	584
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	585 ``commit``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	586 Run after a changeset has been created in the local repository. ID
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	587 of the newly created changeset is in ``$HG_NODE``. Parent changeset
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	588 IDs are in ``$HG_PARENT1`` and ``$HG_PARENT2``.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	589
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	590 ``incoming``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	591 Run after a changeset has been pulled, pushed, or unbundled into
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	592 the local repository. The ID of the newly arrived changeset is in
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	593 ``$HG_NODE``. URL that was source of changes came is in ``$HG_URL``.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	594
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	595 ``outgoing``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	596 Run after sending changes from local repository to another. ID of
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	597 first changeset sent is in ``$HG_NODE``. Source of operation is in
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	598 ``$HG_SOURCE``; see "preoutgoing" hook for description.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	599
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	600 ``post-<command>``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	601 Run after successful invocations of the associated command. The
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	602 contents of the command line are passed as ``$HG_ARGS`` and the result
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	603 code in ``$HG_RESULT``. Parsed command line arguments are passed as
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	604 ``$HG_PATS`` and ``$HG_OPTS``. These contain string representations of
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	605 the python data internally passed to <command>. ``$HG_OPTS`` is a
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	606 dictionary of options (with unspecified options set to their defaults).
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	607 ``$HG_PATS`` is a list of arguments. Hook failure is ignored.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	608
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	609 ``pre-<command>``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	610 Run before executing the associated command. The contents of the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	611 command line are passed as ``$HG_ARGS``. Parsed command line arguments
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	612 are passed as ``$HG_PATS`` and ``$HG_OPTS``. These contain string
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	613 representations of the data internally passed to <command>. ``$HG_OPTS``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	614 is a dictionary of options (with unspecified options set to their
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	615 defaults). ``$HG_PATS`` is a list of arguments. If the hook returns
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	616 failure, the command doesn't execute and Mercurial returns the failure
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	617 code.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	618
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	619 ``prechangegroup``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	620 Run before a changegroup is added via push, pull or unbundle. Exit
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	621 status 0 allows the changegroup to proceed. Non-zero status will
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	622 cause the push, pull or unbundle to fail. URL from which changes
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	623 will come is in ``$HG_URL``.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	624
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	625 ``precommit``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	626 Run before starting a local commit. Exit status 0 allows the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	627 commit to proceed. Non-zero status will cause the commit to fail.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	628 Parent changeset IDs are in ``$HG_PARENT1`` and ``$HG_PARENT2``.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	629
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	630 ``prelistkeys``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	631 Run before listing pushkeys (like bookmarks) in the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	632 repository. Non-zero status will cause failure. The key namespace is
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	633 in ``$HG_NAMESPACE``.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	634
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	635 ``preoutgoing``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	636 Run before collecting changes to send from the local repository to
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	637 another. Non-zero status will cause failure. This lets you prevent
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	638 pull over HTTP or SSH. Also prevents against local pull, push
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	639 (outbound) or bundle commands, but not effective, since you can
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	640 just copy files instead then. Source of operation is in
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	641 ``$HG_SOURCE``. If "serve", operation is happening on behalf of remote
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	642 SSH or HTTP repository. If "push", "pull" or "bundle", operation
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	643 is happening on behalf of repository on same system.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	644
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	645 ``prepushkey``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	646 Run before a pushkey (like a bookmark) is added to the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	647 repository. Non-zero status will cause the key to be rejected. The
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	648 key namespace is in ``$HG_NAMESPACE``, the key is in ``$HG_KEY``,
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	649 the old value (if any) is in ``$HG_OLD``, and the new value is in
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	650 ``$HG_NEW``.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	651
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	652 ``pretag``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	653 Run before creating a tag. Exit status 0 allows the tag to be
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	654 created. Non-zero status will cause the tag to fail. ID of
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	655 changeset to tag is in ``$HG_NODE``. Name of tag is in ``$HG_TAG``. Tag is
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	656 local if ``$HG_LOCAL=1``, in repository if ``$HG_LOCAL=0``.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	657
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	658 ``pretxnchangegroup``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	659 Run after a changegroup has been added via push, pull or unbundle,
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	660 but before the transaction has been committed. Changegroup is
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	661 visible to hook program. This lets you validate incoming changes
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	662 before accepting them. Passed the ID of the first new changeset in
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	663 ``$HG_NODE``. Exit status 0 allows the transaction to commit. Non-zero
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	664 status will cause the transaction to be rolled back and the push,
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	665 pull or unbundle will fail. URL that was source of changes is in
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	666 ``$HG_URL``.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	667
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	668 ``pretxncommit``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	669 Run after a changeset has been created but the transaction not yet
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	670 committed. Changeset is visible to hook program. This lets you
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	671 validate commit message and changes. Exit status 0 allows the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	672 commit to proceed. Non-zero status will cause the transaction to
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	673 be rolled back. ID of changeset is in ``$HG_NODE``. Parent changeset
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	674 IDs are in ``$HG_PARENT1`` and ``$HG_PARENT2``.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	675
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	676 ``preupdate``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	677 Run before updating the working directory. Exit status 0 allows
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	678 the update to proceed. Non-zero status will prevent the update.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	679 Changeset ID of first new parent is in ``$HG_PARENT1``. If merge, ID
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	680 of second new parent is in ``$HG_PARENT2``.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	681
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	682 ``listkeys``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	683 Run after listing pushkeys (like bookmarks) in the repository. The
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	684 key namespace is in ``$HG_NAMESPACE``. ``$HG_VALUES`` is a
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	685 dictionary containing the keys and values.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	686
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	687 ``pushkey``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	688 Run after a pushkey (like a bookmark) is added to the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	689 repository. The key namespace is in ``$HG_NAMESPACE``, the key is in
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	690 ``$HG_KEY``, the old value (if any) is in ``$HG_OLD``, and the new
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	691 value is in ``$HG_NEW``.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	692
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	693 ``tag``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	694 Run after a tag is created. ID of tagged changeset is in ``$HG_NODE``.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	695 Name of tag is in ``$HG_TAG``. Tag is local if ``$HG_LOCAL=1``, in
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	696 repository if ``$HG_LOCAL=0``.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	697
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	698 ``update``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	699 Run after updating the working directory. Changeset ID of first
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	700 new parent is in ``$HG_PARENT1``. If merge, ID of second new parent is
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	701 in ``$HG_PARENT2``. If the update succeeded, ``$HG_ERROR=0``. If the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	702 update failed (e.g. because conflicts not resolved), ``$HG_ERROR=1``.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	703
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	704 .. note:: It is generally better to use standard hooks rather than the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	705 generic pre- and post- command hooks as they are guaranteed to be
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	706 called in the appropriate contexts for influencing transactions.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	707 Also, hooks like "commit" will be called in all contexts that
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	708 generate a commit (e.g. tag) and not just the commit command.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	709
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	710 .. note:: Environment variables with empty values may not be passed to
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	711 hooks on platforms such as Windows. As an example, ``$HG_PARENT2``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	712 will have an empty value under Unix-like platforms for non-merge
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	713 changesets, while it will not be available at all under Windows.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	714
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	715 The syntax for Python hooks is as follows::
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	716
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	717 hookname = python:modulename.submodule.callable
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	718 hookname = python:/path/to/python/module.py:callable
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	719
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	720 Python hooks are run within the Mercurial process. Each hook is
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	721 called with at least three keyword arguments: a ui object (keyword
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	722 ``ui``), a repository object (keyword ``repo``), and a ``hooktype``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	723 keyword that tells what kind of hook is used. Arguments listed as
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	724 environment variables above are passed as keyword arguments, with no
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	725 ``HG_`` prefix, and names in lower case.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	726
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	727 If a Python hook returns a "true" value or raises an exception, this
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	728 is treated as a failure.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	729
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	730
16140 dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	731 ``hostfingerprints``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	732 """"""""""""""""""""
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	733
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	734 Fingerprints of the certificates of known HTTPS servers.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	735 A HTTPS connection to a server with a fingerprint configured here will
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	736 only succeed if the servers certificate matches the fingerprint.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	737 This is very similar to how ssh known hosts works.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	738 The fingerprint is the SHA-1 hash value of the DER encoded certificate.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	739 The CA chain and web.cacerts is not used for servers with a fingerprint.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	740
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	741 For example::
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	742
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	743 [hostfingerprints]
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	744 hg.intevation.org = 38:76:52:7c:87:26:9a:8f:4a:f8:d3:de:08:45:3b:ea:d6:4b:ee:cc
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	745
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	746 This feature is only supported when using Python 2.6 or later.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	747
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	748
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	749 ``http_proxy``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	750 """"""""""""""
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	751
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	752 Used to access web-based Mercurial repositories through a HTTP
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	753 proxy.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	754
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	755 ``host``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	756 Host name and (optional) port of the proxy server, for example
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	757 "myproxy:8000".
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	758
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	759 ``no``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	760 Optional. Comma-separated list of host names that should bypass
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	761 the proxy.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	762
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	763 ``passwd``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	764 Optional. Password to authenticate with at the proxy server.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	765
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	766 ``user``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	767 Optional. User name to authenticate with at the proxy server.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	768
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	769 ``always``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	770 Optional. Always use the proxy, even for localhost and any entries
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	771 in ``http_proxy.no``. True or False. Default: False.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	772
16140 dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	773 ``merge-patterns``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	774 """"""""""""""""""
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	775
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	776 This section specifies merge tools to associate with particular file
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	777 patterns. Tools matched here will take precedence over the default
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	778 merge tool. Patterns are globs by default, rooted at the repository
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	779 root.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	780
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	781 Example::
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	782
16140 dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	783 [merge-patterns]
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	784 **.c = kdiff3
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	785 **.jpg = myimgmerge
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	786
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	787 ``merge-tools``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	788 """""""""""""""
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	789
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	790 This section configures external merge tools to use for file-level
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	791 merges.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	792
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	793 Example ``~/.hgrc``::
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	794
16140 dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	795 [merge-tools]
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	796 # Override stock tool location
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	797 kdiff3.executable = ~/bin/kdiff3
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	798 # Specify command line
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	799 kdiff3.args = $base $local $other -o $output
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	800 # Give higher priority
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	801 kdiff3.priority = 1
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	802
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	803 # Define new tool
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	804 myHtmlTool.args = -m $local $other $base $output
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	805 myHtmlTool.regkey = Software\FooSoftware\HtmlMerge
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	806 myHtmlTool.priority = 1
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	807
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	808 Supported arguments:
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	809
16140 dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	810 ``priority``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	811 The priority in which to evaluate this tool.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	812 Default: 0.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	813
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	814 ``executable``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	815 Either just the name of the executable or its pathname. On Windows,
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	816 the path can use environment variables with ${ProgramFiles} syntax.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	817 Default: the tool name.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	818
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	819 ``args``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	820 The arguments to pass to the tool executable. You can refer to the
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	821 files being merged as well as the output file through these
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	822 variables: ``$base``, ``$local``, ``$other``, ``$output``.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	823 Default: ``$local $base $other``
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	824
16140 dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	825 ``premerge``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	826 Attempt to run internal non-interactive 3-way merge tool before
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	827 launching external tool. Options are ``true``, ``false``, or ``keep``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	828 to leave markers in the file if the premerge fails.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	829 Default: True
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	830
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	831 ``binary``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	832 This tool can merge binary files. Defaults to False, unless tool
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	833 was selected by file pattern match.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	834
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	835 ``symlink``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	836 This tool can merge symlinks. Defaults to False, even if tool was
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	837 selected by file pattern match.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	838
16140 dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	839 ``check``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	840 A list of merge success-checking options:
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	841
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	842 ``changed``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	843 Ask whether merge was successful when the merged file shows no changes.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	844 ``conflicts``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	845 Check whether there are conflicts even though the tool reported success.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	846 ``prompt``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	847 Always prompt for merge success, regardless of success reported by tool.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	848
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	849 ``checkchanged``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	850 True is equivalent to ``check = changed``.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	851 Default: False
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	852
16140 dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	853 ``checkconflicts``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	854 True is equivalent to ``check = conflicts``.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	855 Default: False
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	856
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	857 ``fixeol``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	858 Attempt to fix up EOL changes caused by the merge tool.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	859 Default: False
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	860
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	861 ``gui``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	862 This tool requires a graphical interface to run. Default: False
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	863
16140 dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	864 ``regkey``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	865 Windows registry key which describes install location of this
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	866 tool. Mercurial will search for this key first under
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	867 ``HKEY_CURRENT_USER`` and then under ``HKEY_LOCAL_MACHINE``.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	868 Default: None
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	869
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	870 ``regkeyalt``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	871 An alternate Windows registry key to try if the first key is not
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	872 found. The alternate key uses the same ``regname`` and ``regappend``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	873 semantics of the primary key. The most common use for this key
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	874 is to search for 32bit applications on 64bit operating systems.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	875 Default: None
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	876
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	877 ``regname``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	878 Name of value to read from specified registry key. Defaults to the
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	879 unnamed (default) value.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	880
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	881 ``regappend``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	882 String to append to the value read from the registry, typically
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	883 the executable name of the tool.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	884 Default: None
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	885
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	886
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	887 ``patch``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	888 """""""""
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	889
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	890 Settings used when applying patches, for instance through the 'import'
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	891 command or with Mercurial Queues extension.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	892
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	893 ``eol``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	894 When set to 'strict' patch content and patched files end of lines
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	895 are preserved. When set to ``lf`` or ``crlf``, both files end of
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	896 lines are ignored when patching and the result line endings are
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	897 normalized to either LF (Unix) or CRLF (Windows). When set to
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	898 ``auto``, end of lines are again ignored while patching but line
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	899 endings in patched files are normalized to their original setting
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	900 on a per-file basis. If target file does not exist or has no end
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	901 of line, patch line endings are preserved.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	902 Default: strict.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	903
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	904
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	905 ``paths``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	906 """""""""
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	907
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	908 Assigns symbolic names to repositories. The left side is the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	909 symbolic name, and the right gives the directory or URL that is the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	910 location of the repository. Default paths can be declared by setting
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	911 the following entries.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	912
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	913 ``default``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	914 Directory or URL to use when pulling if no source is specified.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	915 Default is set to repository from which the current repository was
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	916 cloned.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	917
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	918 ``default-push``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	919 Optional. Directory or URL to use when pushing if no destination
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	920 is specified.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	921
15999 76625324bd55 help: add missing phase config items to config topic Matt Mackall <mpm@selenic.com> parents: 15896 diff changeset	922 ``phases``
76625324bd55 help: add missing phase config items to config topic Matt Mackall <mpm@selenic.com> parents: 15896 diff changeset	923 """"""""""
76625324bd55 help: add missing phase config items to config topic Matt Mackall <mpm@selenic.com> parents: 15896 diff changeset	924
16005 591f258ae630 help/config: fix help command markup Wagner Bruna <wbruna@softwareexpress.com.br> parents: 15999 diff changeset	925 Specifies default handling of phases. See :hg:`help phases` for more
15999 76625324bd55 help: add missing phase config items to config topic Matt Mackall <mpm@selenic.com> parents: 15896 diff changeset	926 information about working with phases.
76625324bd55 help: add missing phase config items to config topic Matt Mackall <mpm@selenic.com> parents: 15896 diff changeset	927
76625324bd55 help: add missing phase config items to config topic Matt Mackall <mpm@selenic.com> parents: 15896 diff changeset	928 ``publish``
76625324bd55 help: add missing phase config items to config topic Matt Mackall <mpm@selenic.com> parents: 15896 diff changeset	929 Controls draft phase behavior when working as a server. When true,
76625324bd55 help: add missing phase config items to config topic Matt Mackall <mpm@selenic.com> parents: 15896 diff changeset	930 pushed changesets are set to public in both client and server and
76625324bd55 help: add missing phase config items to config topic Matt Mackall <mpm@selenic.com> parents: 15896 diff changeset	931 pulled or cloned changesets are set to public in the client.
76625324bd55 help: add missing phase config items to config topic Matt Mackall <mpm@selenic.com> parents: 15896 diff changeset	932 Default: True
76625324bd55 help: add missing phase config items to config topic Matt Mackall <mpm@selenic.com> parents: 15896 diff changeset	933
76625324bd55 help: add missing phase config items to config topic Matt Mackall <mpm@selenic.com> parents: 15896 diff changeset	934 ``new-commit``
76625324bd55 help: add missing phase config items to config topic Matt Mackall <mpm@selenic.com> parents: 15896 diff changeset	935 Phase of newly-created commits.
76625324bd55 help: add missing phase config items to config topic Matt Mackall <mpm@selenic.com> parents: 15896 diff changeset	936 Default: draft
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	937
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	938 ``profiling``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	939 """""""""""""
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	940
16392 ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	941 Specifies profiling type, format, and file output. Two profilers are
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	942 supported: an instrumenting profiler (named ``ls``), and a sampling
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	943 profiler (named ``stat``).
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	944
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	945 In this section description, 'profiling data' stands for the raw data
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	946 collected during profiling, while 'profiling report' stands for a
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	947 statistical text report generated from the profiling data. The
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	948 profiling is done using lsprof.
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	949
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	950 ``type``
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	951 The type of profiler to use.
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	952 Default: ls.
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	953
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	954 ``ls``
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	955 Use Python's built-in instrumenting profiler. This profiler
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	956 works on all platforms, but each line number it reports is the
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	957 first line of a function. This restriction makes it difficult to
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	958 identify the expensive parts of a non-trivial function.
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	959 ``stat``
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	960 Use a third-party statistical profiler, statprof. This profiler
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	961 currently runs only on Unix systems, and is most useful for
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	962 profiling commands that run for longer than about 0.1 seconds.
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	963
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	964 ``format``
16392 ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	965 Profiling format. Specific to the ``ls`` instrumenting profiler.
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	966 Default: text.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	967
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	968 ``text``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	969 Generate a profiling report. When saving to a file, it should be
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	970 noted that only the report is saved, and the profiling data is
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	971 not kept.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	972 ``kcachegrind``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	973 Format profiling data for kcachegrind use: when saving to a
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	974 file, the generated file can directly be loaded into
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	975 kcachegrind.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	976
16392 ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	977 ``frequency``
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	978 Sampling frequency. Specific to the ``stat`` sampling profiler.
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	979 Default: 1000.
ee3f423df1b4 dispatch: add support for statprof as a profiler Bryan O'Sullivan <bryano@fb.com> parents: 16391 diff changeset	980
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	981 ``output``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	982 File path where profiling data or report should be saved. If the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	983 file exists, it is replaced. Default: None, data is printed on
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	984 stderr
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	985
14691 b1efd75cdafe help/config: mention [revsetalias] section Wagner Bruna <wbruna@softwareexpress.com.br> parents: 14661 diff changeset	986 ``revsetalias``
b1efd75cdafe help/config: mention [revsetalias] section Wagner Bruna <wbruna@softwareexpress.com.br> parents: 14661 diff changeset	987 """""""""""""""
b1efd75cdafe help/config: mention [revsetalias] section Wagner Bruna <wbruna@softwareexpress.com.br> parents: 14661 diff changeset	988
b1efd75cdafe help/config: mention [revsetalias] section Wagner Bruna <wbruna@softwareexpress.com.br> parents: 14661 diff changeset	989 Alias definitions for revsets. See :hg:`help revsets` for details.
b1efd75cdafe help/config: mention [revsetalias] section Wagner Bruna <wbruna@softwareexpress.com.br> parents: 14661 diff changeset	990
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	991 ``server``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	992 """"""""""
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	993
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	994 Controls generic server settings.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	995
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	996 ``uncompressed``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	997 Whether to allow clients to clone a repository using the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	998 uncompressed streaming protocol. This transfers about 40% more
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	999 data than a regular clone, but uses less memory and CPU on both
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1000 server and client. Over a LAN (100 Mbps or better) or a very fast
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1001 WAN, an uncompressed streaming clone is a lot faster (~10x) than a
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1002 regular clone. Over most WAN connections (anything slower than
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1003 about 6 Mbps), uncompressed streaming is slower, because of the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1004 extra data transfer overhead. This mode will also temporarily hold
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1005 the write lock while determining what data to transfer.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1006 Default is True.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1007
16361 6097ede2be4d protocol: Add the stream-preferred capability Benoit Allard <benoit@aeteurope.nl> parents: 16140 diff changeset	1008 ``preferuncompressed``
6097ede2be4d protocol: Add the stream-preferred capability Benoit Allard <benoit@aeteurope.nl> parents: 16140 diff changeset	1009 When set, clients will try to use the uncompressed streaming
6097ede2be4d protocol: Add the stream-preferred capability Benoit Allard <benoit@aeteurope.nl> parents: 16140 diff changeset	1010 protocol. Default is False.
6097ede2be4d protocol: Add the stream-preferred capability Benoit Allard <benoit@aeteurope.nl> parents: 16140 diff changeset	1011
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1012 ``validate``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1013 Whether to validate the completeness of pushed changesets by
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1014 checking that all new file revisions specified in manifests are
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1015 present. Default is False.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1016
16140 dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1017 ``smtp``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1018 """"""""
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1019
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1020 Configuration for extensions that need to send email messages.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1021
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1022 ``host``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1023 Host name of mail server, e.g. "mail.example.com".
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1024
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1025 ``port``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1026 Optional. Port to connect to on mail server. Default: 25.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1027
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1028 ``tls``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1029 Optional. Method to enable TLS when connecting to mail server: starttls,
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1030 smtps or none. Default: none.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1031
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1032 ``username``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1033 Optional. User name for authenticating with the SMTP server.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1034 Default: none.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1035
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1036 ``password``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1037 Optional. Password for authenticating with the SMTP server. If not
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1038 specified, interactive sessions will prompt the user for a
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1039 password; non-interactive sessions will fail. Default: none.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1040
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1041 ``local_hostname``
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1042 Optional. It's the hostname that the sender can use to identify
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1043 itself to the MTA.
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1044
dbf64594a3c3 help: sort hgrc related "Sections" chapters alphabetically Michal Sznajder <michalsznajder@gmail.com> parents: 16139 diff changeset	1045
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1046 ``subpaths``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1047 """"""""""""
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1048
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1049 Defines subrepositories source locations rewriting rules of the form::
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1050
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1051 <pattern> = <replacement>
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1052
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1053 Where ``pattern`` is a regular expression matching the source and
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1054 ``replacement`` is the replacement string used to rewrite it. Groups
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1055 can be matched in ``pattern`` and referenced in ``replacements``. For
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1056 instance::
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1057
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1058 http://server/(.*)-hg/ = http://hg.server/\1/
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1059
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1060 rewrites ``http://server/foo-hg/`` into ``http://hg.server/foo/``.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1061
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1062 All patterns are applied in definition order.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1063
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1064 ``trusted``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1065 """""""""""
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1066
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1067 Mercurial will not use the settings in the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1068 ``.hg/hgrc`` file from a repository if it doesn't belong to a trusted
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1069 user or to a trusted group, as various hgrc features allow arbitrary
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1070 commands to be run. This issue is often encountered when configuring
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1071 hooks or extensions for shared repositories or servers. However,
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1072 the web interface will use some safe settings from the ``[web]``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1073 section.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1074
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1075 This section specifies what users and groups are trusted. The
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1076 current user is always trusted. To trust everybody, list a user or a
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1077 group with name ``*``. These settings must be placed in an
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1078 already-trusted file to take effect, such as ``$HOME/.hgrc`` of the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1079 user or service running Mercurial.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1080
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1081 ``users``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1082 Comma-separated list of trusted users.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1083
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1084 ``groups``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1085 Comma-separated list of trusted groups.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1086
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1087
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1088 ``ui``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1089 """"""
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1090
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1091 User interface controls.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1092
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1093 ``archivemeta``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1094 Whether to include the .hg_archival.txt file containing meta data
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1095 (hashes for the repository base and for tip) in archives created
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1096 by the :hg:`archive` command or downloaded via hgweb.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1097 Default is True.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1098
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1099 ``askusername``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1100 Whether to prompt for a username when committing. If True, and
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1101 neither ``$HGUSER`` nor ``$EMAIL`` has been specified, then the user will
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1102 be prompted to enter a username. If no username is entered, the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1103 default ``USER@HOST`` is used instead.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1104 Default is False.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1105
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1106 ``commitsubrepos``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1107 Whether to commit modified subrepositories when committing the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1108 parent repository. If False and one subrepository has uncommitted
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1109 changes, abort the commit.
15321 e174353e8cda subrepos: abort commit by default if a subrepo is dirty (BC) Martin Geisler <mg@lazybytes.net> parents: 15046 diff changeset	1110 Default is False.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1111
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1112 ``debug``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1113 Print debugging information. True or False. Default is False.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1114
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1115 ``editor``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1116 The editor to use during a commit. Default is ``$EDITOR`` or ``vi``.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1117
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1118 ``fallbackencoding``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1119 Encoding to try if it's not possible to decode the changelog using
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1120 UTF-8. Default is ISO-8859-1.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1121
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1122 ``ignore``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1123 A file to read per-user ignore patterns from. This file should be
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1124 in the same format as a repository-wide .hgignore file. This
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1125 option supports hook syntax, so if you want to specify multiple
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1126 ignore files, you can do so by setting something like
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1127 ``ignore.other = ~/.hgignore2``. For details of the ignore file
14661 8bbb899620ea help/config: replace docutils markup Wagner Bruna <wbruna@softwareexpress.com.br> parents: 14654 diff changeset	1128 format, see the ``hgignore(5)`` man page.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1129
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1130 ``interactive``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1131 Allow to prompt the user. True or False. Default is True.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1132
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1133 ``logtemplate``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1134 Template string for commands that print changesets.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1135
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1136 ``merge``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1137 The conflict resolution program to use during a manual merge.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1138 For more information on merge tools see :hg:`help merge-tools`.
14654 e21fd445c297 help/config: quote config section names consistently Wagner Bruna <wbruna@softwareexpress.com.br> parents: 14653 diff changeset	1139 For configuring merge tools see the ``[merge-tools]`` section.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1140
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1141 ``portablefilenames``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1142 Check for portable filenames. Can be ``warn``, ``ignore`` or ``abort``.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1143 Default is ``warn``.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1144 If set to ``warn`` (or ``true``), a warning message is printed on POSIX
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1145 platforms, if a file with a non-portable filename is added (e.g. a file
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1146 with a name that can't be created on Windows because it contains reserved
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1147 parts like ``AUX``, reserved characters like ``:``, or would cause a case
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1148 collision with an existing file).
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1149 If set to ``ignore`` (or ``false``), no warning is printed.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1150 If set to ``abort``, the command is aborted.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1151 On Windows, this configuration option is ignored and the command aborted.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1152
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1153 ``quiet``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1154 Reduce the amount of output printed. True or False. Default is False.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1155
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1156 ``remotecmd``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1157 remote command to use for clone/push/pull operations. Default is ``hg``.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1158
16391 9cf7c9d529d0 ui: optionally quiesce ssl verification warnings on python 2.5 Steven Stallion <sstallion@gmail.com> parents: 16383 diff changeset	1159 ``reportoldssl``
9cf7c9d529d0 ui: optionally quiesce ssl verification warnings on python 2.5 Steven Stallion <sstallion@gmail.com> parents: 16383 diff changeset	1160 Warn if an SSL certificate is unable to be due to using Python
9cf7c9d529d0 ui: optionally quiesce ssl verification warnings on python 2.5 Steven Stallion <sstallion@gmail.com> parents: 16383 diff changeset	1161 2.5 or earlier. True or False. Default is True.
9cf7c9d529d0 ui: optionally quiesce ssl verification warnings on python 2.5 Steven Stallion <sstallion@gmail.com> parents: 16383 diff changeset	1162
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1163 ``report_untrusted``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1164 Warn if a ``.hg/hgrc`` file is ignored due to not being owned by a
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1165 trusted user or group. True or False. Default is True.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1166
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1167 ``slash``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1168 Display paths using a slash (``/``) as the path separator. This
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1169 only makes a difference on systems where the default path
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1170 separator is not the slash character (e.g. Windows uses the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1171 backslash character (``\``)).
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1172 Default is False.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1173
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1174 ``ssh``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1175 command to use for SSH connections. Default is ``ssh``.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1176
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1177 ``strict``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1178 Require exact command names, instead of allowing unambiguous
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1179 abbreviations. True or False. Default is False.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1180
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1181 ``style``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1182 Name of style to use for command output.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1183
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1184 ``timeout``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1185 The timeout used when a lock is held (in seconds), a negative value
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1186 means no timeout. Default is 600.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1187
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1188 ``traceback``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1189 Mercurial always prints a traceback when an unknown exception
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1190 occurs. Setting this to True will make Mercurial print a traceback
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1191 on all exceptions, even those recognized by Mercurial (such as
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1192 IOError or MemoryError). Default is False.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1193
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1194 ``username``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1195 The committer of a changeset created when running "commit".
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1196 Typically a person's name and email address, e.g. ``Fred Widget
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1197 <fred@example.com>``. Default is ``$EMAIL`` or ``username@hostname``. If
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1198 the username in hgrc is empty, it has to be specified manually or
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1199 in a different hgrc file (e.g. ``$HOME/.hgrc``, if the admin set
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1200 ``username =`` in the system hgrc). Environment variables in the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1201 username are expanded.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1202
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1203 ``verbose``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1204 Increase the amount of output printed. True or False. Default is False.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1205
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1206
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1207 ``web``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1208 """""""
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1209
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1210 Web interface configuration. The settings in this section apply to
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1211 both the builtin webserver (started by :hg:`serve`) and the script you
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1212 run through a webserver (``hgweb.cgi`` and the derivatives for FastCGI
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1213 and WSGI).
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1214
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1215 The Mercurial webserver does no authentication (it does not prompt for
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1216 usernames and passwords to validate who users are), but it does do
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1217 authorization (it grants or denies access for authenticated users
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1218 based on settings in this section). You must either configure your
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1219 webserver to do authentication for you, or disable the authorization
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1220 checks.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1221
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1222 For a quick setup in a trusted environment, e.g., a private LAN, where
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1223 you want it to accept pushes from anybody, you can use the following
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1224 command line::
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1225
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1226 $ hg --config web.allow_push=* --config web.push_ssl=False serve
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1227
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1228 Note that this will allow anybody to push anything to the server and
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1229 that this should not be used for public servers.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1230
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1231 The full set of options is:
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1232
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1233 ``accesslog``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1234 Where to output the access log. Default is stdout.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1235
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1236 ``address``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1237 Interface address to bind to. Default is all.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1238
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1239 ``allow_archive``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1240 List of archive format (bz2, gz, zip) allowed for downloading.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1241 Default is empty.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1242
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1243 ``allowbz2``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1244 (DEPRECATED) Whether to allow .tar.bz2 downloading of repository
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1245 revisions.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1246 Default is False.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1247
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1248 ``allowgz``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1249 (DEPRECATED) Whether to allow .tar.gz downloading of repository
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1250 revisions.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1251 Default is False.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1252
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1253 ``allowpull``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1254 Whether to allow pulling from the repository. Default is True.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1255
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1256 ``allow_push``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1257 Whether to allow pushing to the repository. If empty or not set,
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1258 push is not allowed. If the special value ``*``, any remote user can
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1259 push, including unauthenticated users. Otherwise, the remote user
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1260 must have been authenticated, and the authenticated user name must
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1261 be present in this list. The contents of the allow_push list are
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1262 examined after the deny_push list.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1263
15004 d06b9c55ddab hgweb: raw file mimetype guessing configurable, off by default (BC) (issue2923) Matt Mackall <mpm@selenic.com> parents: 14691 diff changeset	1264 ``guessmime``
d06b9c55ddab hgweb: raw file mimetype guessing configurable, off by default (BC) (issue2923) Matt Mackall <mpm@selenic.com> parents: 14691 diff changeset	1265 Control MIME types for raw download of file content.
d06b9c55ddab hgweb: raw file mimetype guessing configurable, off by default (BC) (issue2923) Matt Mackall <mpm@selenic.com> parents: 14691 diff changeset	1266 Set to True to let hgweb guess the content type from the file
d06b9c55ddab hgweb: raw file mimetype guessing configurable, off by default (BC) (issue2923) Matt Mackall <mpm@selenic.com> parents: 14691 diff changeset	1267 extension. This will serve HTML files as ``text/html`` and might
d06b9c55ddab hgweb: raw file mimetype guessing configurable, off by default (BC) (issue2923) Matt Mackall <mpm@selenic.com> parents: 14691 diff changeset	1268 allow cross-site scripting attacks when serving untrusted
d06b9c55ddab hgweb: raw file mimetype guessing configurable, off by default (BC) (issue2923) Matt Mackall <mpm@selenic.com> parents: 14691 diff changeset	1269 repositories. Default is False.
15045 7f504202cb5c help/config: strip trailing whitespace Wagner Bruna <wbruna@yahoo.com> parents: 15005 diff changeset	1270
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1271 ``allow_read``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1272 If the user has not already been denied repository access due to
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1273 the contents of deny_read, this list determines whether to grant
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1274 repository access to the user. If this list is not empty, and the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1275 user is unauthenticated or not present in the list, then access is
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1276 denied for the user. If the list is empty or not set, then access
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1277 is permitted to all users by default. Setting allow_read to the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1278 special value ``*`` is equivalent to it not being set (i.e. access
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1279 is permitted to all users). The contents of the allow_read list are
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1280 examined after the deny_read list.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1281
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1282 ``allowzip``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1283 (DEPRECATED) Whether to allow .zip downloading of repository
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1284 revisions. Default is False. This feature creates temporary files.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1285
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1286 ``baseurl``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1287 Base URL to use when publishing URLs in other locations, so
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1288 third-party tools like email notification hooks can construct
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1289 URLs. Example: ``http://hgserver/repos/``.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1290
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1291 ``cacerts``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1292 Path to file containing a list of PEM encoded certificate
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1293 authority certificates. Environment variables and ``~user``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1294 constructs are expanded in the filename. If specified on the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1295 client, then it will verify the identity of remote HTTPS servers
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1296 with these certificates. The form must be as follows::
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1297
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1298 -----BEGIN CERTIFICATE-----
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1299 ... (certificate in base64 PEM encoding) ...
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1300 -----END CERTIFICATE-----
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1301 -----BEGIN CERTIFICATE-----
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1302 ... (certificate in base64 PEM encoding) ...
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1303 -----END CERTIFICATE-----
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1304
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1305 This feature is only supported when using Python 2.6 or later. If you wish
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1306 to use it with earlier versions of Python, install the backported
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1307 version of the ssl library that is available from
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1308 ``http://pypi.python.org``.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1309
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1310 You can use OpenSSL's CA certificate file if your platform has one.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1311 On most Linux systems this will be ``/etc/ssl/certs/ca-certificates.crt``.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1312 Otherwise you will have to generate this file manually.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1313
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1314 To disable SSL verification temporarily, specify ``--insecure`` from
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1315 command line.
14457 5818f5d49127 help/config: fix rendering of definition list Martin Geisler <mg@lazybytes.net> parents: 14456 diff changeset	1316
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1317 ``cache``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1318 Whether to support caching in hgweb. Defaults to True.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1319
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1320 ``contact``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1321 Name or email address of the person in charge of the repository.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1322 Defaults to ui.username or ``$EMAIL`` or "unknown" if unset or empty.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1323
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1324 ``deny_push``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1325 Whether to deny pushing to the repository. If empty or not set,
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1326 push is not denied. If the special value ``*``, all remote users are
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1327 denied push. Otherwise, unauthenticated users are all denied, and
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1328 any authenticated user name present in this list is also denied. The
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1329 contents of the deny_push list are examined before the allow_push list.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1330
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1331 ``deny_read``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1332 Whether to deny reading/viewing of the repository. If this list is
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1333 not empty, unauthenticated users are all denied, and any
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1334 authenticated user name present in this list is also denied access to
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1335 the repository. If set to the special value ``*``, all remote users
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1336 are denied access (rarely needed ;). If deny_read is empty or not set,
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1337 the determination of repository access depends on the presence and
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1338 content of the allow_read list (see description). If both
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1339 deny_read and allow_read are empty or not set, then access is
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1340 permitted to all users by default. If the repository is being
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1341 served via hgwebdir, denied users will not be able to see it in
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1342 the list of repositories. The contents of the deny_read list have
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1343 priority over (are examined before) the contents of the allow_read
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1344 list.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1345
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1346 ``descend``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1347 hgwebdir indexes will not descend into subdirectories. Only repositories
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1348 directly in the current path will be shown (other repositories are still
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1349 available from the index corresponding to their containing path).
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1350
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1351 ``description``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1352 Textual description of the repository's purpose or contents.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1353 Default is "unknown".
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1354
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1355 ``encoding``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1356 Character encoding name. Default is the current locale charset.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1357 Example: "UTF-8"
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1358
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1359 ``errorlog``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1360 Where to output the error log. Default is stderr.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1361
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1362 ``hidden``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1363 Whether to hide the repository in the hgwebdir index.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1364 Default is False.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1365
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1366 ``ipv6``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1367 Whether to use IPv6. Default is False.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1368
14938 ec18cd254156 help: add "web/logoimg" setting description Angel Ezquerra <angel.ezquerra@gmail.com> parents: 14891 diff changeset	1369 ``logoimg``
ec18cd254156 help: add "web/logoimg" setting description Angel Ezquerra <angel.ezquerra@gmail.com> parents: 14891 diff changeset	1370 File name of the logo image that some templates display on each page.
ec18cd254156 help: add "web/logoimg" setting description Angel Ezquerra <angel.ezquerra@gmail.com> parents: 14891 diff changeset	1371 The file name is relative to ``staticurl``. That is, the full path to
ec18cd254156 help: add "web/logoimg" setting description Angel Ezquerra <angel.ezquerra@gmail.com> parents: 14891 diff changeset	1372 the logo image is "staticurl/logoimg".
ec18cd254156 help: add "web/logoimg" setting description Angel Ezquerra <angel.ezquerra@gmail.com> parents: 14891 diff changeset	1373 If unset, ``hglogo.png`` will be used.
ec18cd254156 help: add "web/logoimg" setting description Angel Ezquerra <angel.ezquerra@gmail.com> parents: 14891 diff changeset	1374
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1375 ``logourl``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1376 Base URL to use for logos. If unset, ``http://mercurial.selenic.com/``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1377 will be used.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1378
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1379 ``name``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1380 Repository name to use in the web interface. Default is current
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1381 working directory.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1382
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1383 ``maxchanges``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1384 Maximum number of changes to list on the changelog. Default is 10.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1385
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1386 ``maxfiles``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1387 Maximum number of files to list per changeset. Default is 10.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1388
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1389 ``port``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1390 Port to listen on. Default is 8000.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1391
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1392 ``prefix``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1393 Prefix path to serve from. Default is '' (server root).
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1394
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1395 ``push_ssl``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1396 Whether to require that inbound pushes be transported over SSL to
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1397 prevent password sniffing. Default is True.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1398
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1399 ``staticurl``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1400 Base URL to use for static files. If unset, static files (e.g. the
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1401 hgicon.png favicon) will be served by the CGI script itself. Use
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1402 this setting to serve them directly with the HTTP server.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1403 Example: ``http://hgserver/static/``.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1404
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1405 ``stripes``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1406 How many lines a "zebra stripe" should span in multiline output.
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1407 Default is 1; set to 0 to disable.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1408
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1409 ``style``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1410 Which template map style to use.
14458 c62b3b74f1d2 help/config: separate terms with a blank line Martin Geisler <mg@lazybytes.net> parents: 14457 diff changeset	1411
14456 ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1412 ``templates``
ff4126ce9301 help: move part of hgrc.5 man page config help topic Yun Lee <yun.lee.bj@gmail.com> parents: 13955 diff changeset	1413 Where to find the HTML templates. Default is install path.

Mercurial > public > mercurial-scm > hg-stable

annotate mercurial/help/config.txt @ 16392:ee3f423df1b4