mercurial-crew-with-dirclash: doc/hgrc.5.txt annotate

annotate doc/hgrc.5.txt @ 3685:193e9c6d1a6d

Issue424: mq patch loses guard when qrenamed

author	Mathieu Clabaut <mathieu.clabaut@gmail.com>
date	Sun, 19 Nov 2006 23:47:19 +0100
parents	cf001fb04109
children	98f2507c5551

rev	line source
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	1 HGRC(5)
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	2 =======
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	3 Bryan O'Sullivan <bos@serpentine.com>
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	4
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	5 NAME
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	6 ----
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	7 hgrc - configuration files for Mercurial
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	8
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	9 SYNOPSIS
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	10 --------
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	11
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	12 The Mercurial system uses a set of configuration files to control
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	13 aspects of its behaviour.
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	14
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	15 FILES
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	16 -----
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	17
1583 32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	18 Mercurial reads configuration data from several files, if they exist.
32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	19 The names of these files depend on the system on which Mercurial is
32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	20 installed.
951 859de3ebc041 Read global config file /etc/mercurial/hgrc and fix reading hgrc on Windows. Thomas Arendsen Hein <thomas@intevation.de> parents: 938 diff changeset	21
1583 32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	22 (Unix) <install-root>/etc/mercurial/hgrc.d/*.rc::
32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	23 (Unix) <install-root>/etc/mercurial/hgrc::
32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	24 Per-installation configuration files, searched for in the
32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	25 directory where Mercurial is installed. For example, if installed
32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	26 in /shared/tools, Mercurial will look in
32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	27 /shared/tools/etc/mercurial/hgrc. Options in these files apply to
32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	28 all Mercurial commands executed by any user in any directory.
32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	29
32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	30 (Unix) /etc/mercurial/hgrc.d/*.rc::
1304 a69e5a67685c Update hgrc documentation to refer to Windows paths. Bryan O'Sullivan <bos@serpentine.com> parents: 1293 diff changeset	31 (Unix) /etc/mercurial/hgrc::
a69e5a67685c Update hgrc documentation to refer to Windows paths. Bryan O'Sullivan <bos@serpentine.com> parents: 1293 diff changeset	32 (Windows) C:\Mercurial\Mercurial.ini::
1583 32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	33 Per-system configuration files, for the system on which Mercurial
32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	34 is running. Options in these files apply to all Mercurial
32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	35 commands executed by any user in any directory. Options in these
32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	36 files override per-installation options.
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	37
1304 a69e5a67685c Update hgrc documentation to refer to Windows paths. Bryan O'Sullivan <bos@serpentine.com> parents: 1293 diff changeset	38 (Unix) $HOME/.hgrc::
2318 94d628499235 If HOME is defined on Windows, Mercurial uses it. Document this. FUJIWARA Katsunori <foozy@lares.dti.ne.jp> parents: 2292 diff changeset	39 (Windows) C:\Documents and Settings\USERNAME\Mercurial.ini::
94d628499235 If HOME is defined on Windows, Mercurial uses it. Document this. FUJIWARA Katsunori <foozy@lares.dti.ne.jp> parents: 2292 diff changeset	40 (Windows) $HOME\Mercurial.ini::
1583 32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	41 Per-user configuration file, for the user running Mercurial.
32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	42 Options in this file apply to all Mercurial commands executed by
32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	43 any user in any directory. Options in this file override
32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	44 per-installation and per-system options.
2318 94d628499235 If HOME is defined on Windows, Mercurial uses it. Document this. FUJIWARA Katsunori <foozy@lares.dti.ne.jp> parents: 2292 diff changeset	45 On Windows system, one of these is chosen exclusively according
94d628499235 If HOME is defined on Windows, Mercurial uses it. Document this. FUJIWARA Katsunori <foozy@lares.dti.ne.jp> parents: 2292 diff changeset	46 to definition of HOME environment variable.
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	47
1304 a69e5a67685c Update hgrc documentation to refer to Windows paths. Bryan O'Sullivan <bos@serpentine.com> parents: 1293 diff changeset	48 (Unix, Windows) <repo>/.hg/hgrc::
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	49 Per-repository configuration options that only apply in a
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	50 particular repository. This file is not version-controlled, and
1583 32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	51 will not get transferred during a "clone" operation. Options in
32a4e6802864 make mercurial look in more places for config files. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1485 diff changeset	52 this file override options in all other configuration files.
3538 9b52239dc740 save settings from untrusted config files in a separate configparser Alexis S. L. Carvalho <alexis@cecm.usp.br> parents: 3537 diff changeset	53 On Unix, most of this file will be ignored if it doesn't belong
9b52239dc740 save settings from untrusted config files in a separate configparser Alexis S. L. Carvalho <alexis@cecm.usp.br> parents: 3537 diff changeset	54 to a trusted user or to a trusted group. See the documentation
9b52239dc740 save settings from untrusted config files in a separate configparser Alexis S. L. Carvalho <alexis@cecm.usp.br> parents: 3537 diff changeset	55 for the trusted section below for more details.
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	56
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	57 SYNTAX
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	58 ------
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	59
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	60 A configuration file consists of sections, led by a "[section]" header
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	61 and followed by "name: value" entries; "name=value" is also accepted.
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	62
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	63 [spam]
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	64 eggs=ham
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	65 green=
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	66 eggs
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	67
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	68 Each line contains one entry. If the lines that follow are indented,
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	69 they are treated as continuations of that entry.
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	70
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	71 Leading whitespace is removed from values. Empty lines are skipped.
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	72
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	73 The optional values can contain format strings which refer to other
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	74 values in the same section, or values in a special DEFAULT section.
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	75
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	76 Lines beginning with "#" or ";" are ignored and may be used to provide
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	77 comments.
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	78
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	79 SECTIONS
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	80 --------
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	81
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	82 This section describes the different sections that may appear in a
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	83 Mercurial "hgrc" file, the purpose of each section, its possible
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	84 keys, and their possible values.
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	85
1308 2073e5a71008 Cleanup of tabs and trailing spaces. Thomas Arendsen Hein <thomas@intevation.de> parents: 1258 diff changeset	86 decode/encode::
1258 1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	87 Filters for transforming files on checkout/checkin. This would
1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	88 typically be used for newline processing or other
1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	89 localization/canonicalization of files.
1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	90
1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	91 Filters consist of a filter pattern followed by a filter command.
1293 a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	92 Filter patterns are globs by default, rooted at the repository
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	93 root. For example, to match any file ending in ".txt" in the root
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	94 directory only, use the pattern "*.txt". To match any file ending
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	95 in ".c" anywhere in the repository, use the pattern "**.c".
1258 1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	96
1293 a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	97 The filter command can start with a specifier, either "pipe:" or
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	98 "tempfile:". If no specifier is given, "pipe:" is used by default.
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	99
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	100 A "pipe:" command must accept data on stdin and return the
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	101 transformed data on stdout.
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	102
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	103 Pipe example:
1258 1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	104
1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	105 [encode]
1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	106 # uncompress gzip files on checkin to improve delta compression
1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	107 # note: not necessarily a good idea, just an example
1293 a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	108 *.gz = pipe: gunzip
1258 1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	109
1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	110 [decode]
1293 a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	111 # recompress gzip files when writing them to the working dir (we
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	112 # can safely omit "pipe:", because it's the default)
1258 1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	113 *.gz = gzip
1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	114
1293 a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	115 A "tempfile:" command is a template. The string INFILE is replaced
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	116 with the name of a temporary file that contains the data to be
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	117 filtered by the command. The string OUTFILE is replaced with the
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	118 name of an empty temporary file, where the filtered data must be
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	119 written by the command.
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	120
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	121 NOTE: the tempfile mechanism is recommended for Windows systems,
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	122 where the standard shell I/O redirection operators often have
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	123 strange effects. In particular, if you are doing line ending
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	124 conversion on Windows using the popular dos2unix and unix2dos
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	125 programs, you must use the tempfile mechanism, as using pipes will
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	126 corrupt the contents of your files.
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	127
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	128 Tempfile example:
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	129
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	130 [encode]
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	131 # convert files to unix line ending conventions on checkin
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	132 **.txt = tempfile: dos2unix -n INFILE OUTFILE
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	133
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	134 [decode]
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	135 # convert files to windows line ending conventions when writing
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	136 # them to the working dir
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	137 **.txt = tempfile: unix2dos -n INFILE OUTFILE
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	138
3036 77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	139 defaults::
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	140 Use the [defaults] section to define command defaults, i.e. the
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	141 default options/arguments to pass to the specified commands.
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	142
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	143 The following example makes 'hg log' run in verbose mode, and
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	144 'hg status' show only the modified files, by default.
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	145
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	146 [defaults]
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	147 log = -v
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	148 status = -m
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	149
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	150 The actual commands, instead of their aliases, must be used when
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	151 defining command defaults. The command defaults will also be
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	152 applied to the aliases of the commands defined.
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	153
2200 9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	154 email::
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	155 Settings for extensions that send email messages.
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	156 from;;
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	157 Optional. Email address to use in "From" header and SMTP envelope
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	158 of outgoing messages.
2680 d071a9cc2f94 added documentation for to, cc, and bcc addressing Christian Ebert <blacktrash@gmx.net> parents: 2678 diff changeset	159 to;;
2691 accadcb4e4b5 email: reflect that recipients are specified as comma-separated list Christian Ebert <blacktrash@gmx.net> parents: 2680 diff changeset	160 Optional. Comma-separated list of recipients' email addresses.
2680 d071a9cc2f94 added documentation for to, cc, and bcc addressing Christian Ebert <blacktrash@gmx.net> parents: 2678 diff changeset	161 cc;;
2691 accadcb4e4b5 email: reflect that recipients are specified as comma-separated list Christian Ebert <blacktrash@gmx.net> parents: 2680 diff changeset	162 Optional. Comma-separated list of carbon copy recipients'
accadcb4e4b5 email: reflect that recipients are specified as comma-separated list Christian Ebert <blacktrash@gmx.net> parents: 2680 diff changeset	163 email addresses.
2680 d071a9cc2f94 added documentation for to, cc, and bcc addressing Christian Ebert <blacktrash@gmx.net> parents: 2678 diff changeset	164 bcc;;
2691 accadcb4e4b5 email: reflect that recipients are specified as comma-separated list Christian Ebert <blacktrash@gmx.net> parents: 2680 diff changeset	165 Optional. Comma-separated list of blind carbon copy
accadcb4e4b5 email: reflect that recipients are specified as comma-separated list Christian Ebert <blacktrash@gmx.net> parents: 2680 diff changeset	166 recipients' email addresses. Cannot be set interactively.
2292 903ab41ac7eb allow to send email using sendmail. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2288 diff changeset	167 method;;
903ab41ac7eb allow to send email using sendmail. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2288 diff changeset	168 Optional. Method to use to send email messages. If value is
2678 a781df9b5faa fix reference to "smtp" section Christian Ebert <blacktrash@gmx.net> parents: 2673 diff changeset	169 "smtp" (default), use SMTP (see section "[smtp]" for
2292 903ab41ac7eb allow to send email using sendmail. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2288 diff changeset	170 configuration). Otherwise, use as name of program to run that
903ab41ac7eb allow to send email using sendmail. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2288 diff changeset	171 acts like sendmail (takes "-f" option for sender, list of
903ab41ac7eb allow to send email using sendmail. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2288 diff changeset	172 recipients on command line, message on stdin). Normally, setting
903ab41ac7eb allow to send email using sendmail. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2288 diff changeset	173 this to "sendmail" or "/usr/sbin/sendmail" is enough to use
903ab41ac7eb allow to send email using sendmail. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2288 diff changeset	174 sendmail to send messages.
903ab41ac7eb allow to send email using sendmail. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2288 diff changeset	175
903ab41ac7eb allow to send email using sendmail. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2288 diff changeset	176 Email example:
903ab41ac7eb allow to send email using sendmail. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2288 diff changeset	177
903ab41ac7eb allow to send email using sendmail. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2288 diff changeset	178 [email]
903ab41ac7eb allow to send email using sendmail. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2288 diff changeset	179 from = Joseph User <joe.user@example.com>
903ab41ac7eb allow to send email using sendmail. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2288 diff changeset	180 method = /usr/sbin/sendmail
2200 9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	181
2211 b8b7a79a4d88 document [extensions] in doc/hgrc.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2209 diff changeset	182 extensions::
b8b7a79a4d88 document [extensions] in doc/hgrc.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2209 diff changeset	183 Mercurial has an extension mechanism for adding new features. To
b8b7a79a4d88 document [extensions] in doc/hgrc.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2209 diff changeset	184 enable an extension, create an entry for it in this section.
b8b7a79a4d88 document [extensions] in doc/hgrc.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2209 diff changeset	185
b8b7a79a4d88 document [extensions] in doc/hgrc.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2209 diff changeset	186 If you know that the extension is already in Python's search path,
b8b7a79a4d88 document [extensions] in doc/hgrc.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2209 diff changeset	187 you can give the name of the module, followed by "=", with nothing
b8b7a79a4d88 document [extensions] in doc/hgrc.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2209 diff changeset	188 after the "=".
b8b7a79a4d88 document [extensions] in doc/hgrc.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2209 diff changeset	189
b8b7a79a4d88 document [extensions] in doc/hgrc.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2209 diff changeset	190 Otherwise, give a name that you choose, followed by "=", followed by
b8b7a79a4d88 document [extensions] in doc/hgrc.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2209 diff changeset	191 the path to the ".py" file (including the file name extension) that
b8b7a79a4d88 document [extensions] in doc/hgrc.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2209 diff changeset	192 defines the extension.
b8b7a79a4d88 document [extensions] in doc/hgrc.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2209 diff changeset	193
2387 62ce297f214f Expand '~' in path to extensions. Markus F.X.J. Oberhumer <markus@oberhumer.com> parents: 2358 diff changeset	194 Example for ~/.hgrc:
62ce297f214f Expand '~' in path to extensions. Markus F.X.J. Oberhumer <markus@oberhumer.com> parents: 2358 diff changeset	195
62ce297f214f Expand '~' in path to extensions. Markus F.X.J. Oberhumer <markus@oberhumer.com> parents: 2358 diff changeset	196 [extensions]
62ce297f214f Expand '~' in path to extensions. Markus F.X.J. Oberhumer <markus@oberhumer.com> parents: 2358 diff changeset	197 # (the mq extension will get loaded from mercurial's path)
62ce297f214f Expand '~' in path to extensions. Markus F.X.J. Oberhumer <markus@oberhumer.com> parents: 2358 diff changeset	198 hgext.mq =
62ce297f214f Expand '~' in path to extensions. Markus F.X.J. Oberhumer <markus@oberhumer.com> parents: 2358 diff changeset	199 # (this extension will get loaded from the file specified)
62ce297f214f Expand '~' in path to extensions. Markus F.X.J. Oberhumer <markus@oberhumer.com> parents: 2358 diff changeset	200 myfeature = ~/.hgext/myfeature.py
62ce297f214f Expand '~' in path to extensions. Markus F.X.J. Oberhumer <markus@oberhumer.com> parents: 2358 diff changeset	201
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	202 hooks::
2155 ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	203 Commands or Python functions that get automatically executed by
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	204 various actions such as starting or finishing a commit. Multiple
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	205 hooks can be run for the same action by appending a suffix to the
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	206 action. Overriding a site-wide hook can be done by changing its
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	207 value or setting it to an empty string.
1485 625f3f13d7be mention running multiple hooks in the doc Benoit Boissinot <benoit.boissinot@ens-lyon.org> parents: 1316 diff changeset	208
625f3f13d7be mention running multiple hooks in the doc Benoit Boissinot <benoit.boissinot@ens-lyon.org> parents: 1316 diff changeset	209 Example .hg/hgrc:
625f3f13d7be mention running multiple hooks in the doc Benoit Boissinot <benoit.boissinot@ens-lyon.org> parents: 1316 diff changeset	210
625f3f13d7be mention running multiple hooks in the doc Benoit Boissinot <benoit.boissinot@ens-lyon.org> parents: 1316 diff changeset	211 [hooks]
625f3f13d7be mention running multiple hooks in the doc Benoit Boissinot <benoit.boissinot@ens-lyon.org> parents: 1316 diff changeset	212 # do not use the site-wide hook
1714 eabfbd220f39 fix hgrc doc hook descriptions. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1583 diff changeset	213 incoming =
eabfbd220f39 fix hgrc doc hook descriptions. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1583 diff changeset	214 incoming.email = /my/email/hook
eabfbd220f39 fix hgrc doc hook descriptions. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1583 diff changeset	215 incoming.autobuild = /my/build/hook
1485 625f3f13d7be mention running multiple hooks in the doc Benoit Boissinot <benoit.boissinot@ens-lyon.org> parents: 1316 diff changeset	216
1727 019e6a47a53e fix names of parent changeset ids in hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1726 diff changeset	217 Most hooks are run with environment variables set that give added
019e6a47a53e fix names of parent changeset ids in hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1726 diff changeset	218 useful information. For each hook below, the environment variables
019e6a47a53e fix names of parent changeset ids in hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1726 diff changeset	219 it is passed are listed with names of the form "$HG_foo".
019e6a47a53e fix names of parent changeset ids in hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1726 diff changeset	220
1171 a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	221 changegroup;;
1730 0f1d2c75db5e add prechangegroup and pretxnchangegroup hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1721 diff changeset	222 Run after a changegroup has been added via push, pull or
2673 109a22f5434a hooks: add url to changegroup, incoming, prechangegroup, pretxnchangegroup hooks Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2666 diff changeset	223 unbundle. ID of the first new changeset is in $HG_NODE. URL from
109a22f5434a hooks: add url to changegroup, incoming, prechangegroup, pretxnchangegroup hooks Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2666 diff changeset	224 which changes came is in $HG_URL.
1171 a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	225 commit;;
1714 eabfbd220f39 fix hgrc doc hook descriptions. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1583 diff changeset	226 Run after a changeset has been created in the local repository.
1727 019e6a47a53e fix names of parent changeset ids in hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1726 diff changeset	227 ID of the newly created changeset is in $HG_NODE. Parent
019e6a47a53e fix names of parent changeset ids in hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1726 diff changeset	228 changeset IDs are in $HG_PARENT1 and $HG_PARENT2.
1714 eabfbd220f39 fix hgrc doc hook descriptions. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1583 diff changeset	229 incoming;;
eabfbd220f39 fix hgrc doc hook descriptions. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1583 diff changeset	230 Run after a changeset has been pulled, pushed, or unbundled into
1727 019e6a47a53e fix names of parent changeset ids in hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1726 diff changeset	231 the local repository. The ID of the newly arrived changeset is in
2673 109a22f5434a hooks: add url to changegroup, incoming, prechangegroup, pretxnchangegroup hooks Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2666 diff changeset	232 $HG_NODE. URL that was source of changes came is in $HG_URL.
1736 50de0887bbcd add preoutgoing and outgoing hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1734 diff changeset	233 outgoing;;
50de0887bbcd add preoutgoing and outgoing hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1734 diff changeset	234 Run after sending changes from local repository to another. ID of
50de0887bbcd add preoutgoing and outgoing hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1734 diff changeset	235 first changeset sent is in $HG_NODE. Source of operation is in
50de0887bbcd add preoutgoing and outgoing hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1734 diff changeset	236 $HG_SOURCE; see "preoutgoing" hook for description.
1730 0f1d2c75db5e add prechangegroup and pretxnchangegroup hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1721 diff changeset	237 prechangegroup;;
0f1d2c75db5e add prechangegroup and pretxnchangegroup hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1721 diff changeset	238 Run before a changegroup is added via push, pull or unbundle.
0f1d2c75db5e add prechangegroup and pretxnchangegroup hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1721 diff changeset	239 Exit status 0 allows the changegroup to proceed. Non-zero status
2673 109a22f5434a hooks: add url to changegroup, incoming, prechangegroup, pretxnchangegroup hooks Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2666 diff changeset	240 will cause the push, pull or unbundle to fail. URL from which
109a22f5434a hooks: add url to changegroup, incoming, prechangegroup, pretxnchangegroup hooks Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2666 diff changeset	241 changes will come is in $HG_URL.
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	242 precommit;;
1721 801756d0ca84 add pretxncommit hook. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1720 diff changeset	243 Run before starting a local commit. Exit status 0 allows the
1726 56fb048b102c prefix hook env var names with HG_. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1721 diff changeset	244 commit to proceed. Non-zero status will cause the commit to fail.
1727 019e6a47a53e fix names of parent changeset ids in hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1726 diff changeset	245 Parent changeset IDs are in $HG_PARENT1 and $HG_PARENT2.
1736 50de0887bbcd add preoutgoing and outgoing hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1734 diff changeset	246 preoutgoing;;
50de0887bbcd add preoutgoing and outgoing hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1734 diff changeset	247 Run before computing changes to send from the local repository to
50de0887bbcd add preoutgoing and outgoing hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1734 diff changeset	248 another. Non-zero status will cause failure. This lets you
50de0887bbcd add preoutgoing and outgoing hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1734 diff changeset	249 prevent pull over http or ssh. Also prevents against local pull,
50de0887bbcd add preoutgoing and outgoing hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1734 diff changeset	250 push (outbound) or bundle commands, but not effective, since you
50de0887bbcd add preoutgoing and outgoing hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1734 diff changeset	251 can just copy files instead then. Source of operation is in
50de0887bbcd add preoutgoing and outgoing hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1734 diff changeset	252 $HG_SOURCE. If "serve", operation is happening on behalf of
50de0887bbcd add preoutgoing and outgoing hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1734 diff changeset	253 remote ssh or http repository. If "push", "pull" or "bundle",
50de0887bbcd add preoutgoing and outgoing hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1734 diff changeset	254 operation is happening on behalf of repository on same system.
1720 55017891051b add pretag and tag hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1714 diff changeset	255 pretag;;
55017891051b add pretag and tag hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1714 diff changeset	256 Run before creating a tag. Exit status 0 allows the tag to be
55017891051b add pretag and tag hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1714 diff changeset	257 created. Non-zero status will cause the tag to fail. ID of
1727 019e6a47a53e fix names of parent changeset ids in hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1726 diff changeset	258 changeset to tag is in $HG_NODE. Name of tag is in $HG_TAG. Tag
019e6a47a53e fix names of parent changeset ids in hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1726 diff changeset	259 is local if $HG_LOCAL=1, in repo if $HG_LOCAL=0.
1730 0f1d2c75db5e add prechangegroup and pretxnchangegroup hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1721 diff changeset	260 pretxnchangegroup;;
0f1d2c75db5e add prechangegroup and pretxnchangegroup hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1721 diff changeset	261 Run after a changegroup has been added via push, pull or unbundle,
0f1d2c75db5e add prechangegroup and pretxnchangegroup hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1721 diff changeset	262 but before the transaction has been committed. Changegroup is
0f1d2c75db5e add prechangegroup and pretxnchangegroup hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1721 diff changeset	263 visible to hook program. This lets you validate incoming changes
0f1d2c75db5e add prechangegroup and pretxnchangegroup hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1721 diff changeset	264 before accepting them. Passed the ID of the first new changeset
1734 9488d53233b5 tests for new hooks. fix things i found when writing tests. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1732 diff changeset	265 in $HG_NODE. Exit status 0 allows the transaction to commit.
1730 0f1d2c75db5e add prechangegroup and pretxnchangegroup hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1721 diff changeset	266 Non-zero status will cause the transaction to be rolled back and
2673 109a22f5434a hooks: add url to changegroup, incoming, prechangegroup, pretxnchangegroup hooks Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2666 diff changeset	267 the push, pull or unbundle will fail. URL that was source of
109a22f5434a hooks: add url to changegroup, incoming, prechangegroup, pretxnchangegroup hooks Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2666 diff changeset	268 changes is in $HG_URL.
1721 801756d0ca84 add pretxncommit hook. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1720 diff changeset	269 pretxncommit;;
801756d0ca84 add pretxncommit hook. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1720 diff changeset	270 Run after a changeset has been created but the transaction not yet
801756d0ca84 add pretxncommit hook. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1720 diff changeset	271 committed. Changeset is visible to hook program. This lets you
801756d0ca84 add pretxncommit hook. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1720 diff changeset	272 validate commit message and changes. Exit status 0 allows the
801756d0ca84 add pretxncommit hook. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1720 diff changeset	273 commit to proceed. Non-zero status will cause the transaction to
1727 019e6a47a53e fix names of parent changeset ids in hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1726 diff changeset	274 be rolled back. ID of changeset is in $HG_NODE. Parent changeset
019e6a47a53e fix names of parent changeset ids in hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1726 diff changeset	275 IDs are in $HG_PARENT1 and $HG_PARENT2.
2266 3f7692b0ff13 hooks: add preupdate and update hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2211 diff changeset	276 preupdate;;
3f7692b0ff13 hooks: add preupdate and update hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2211 diff changeset	277 Run before updating the working directory. Exit status 0 allows
3f7692b0ff13 hooks: add preupdate and update hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2211 diff changeset	278 the update to proceed. Non-zero status will prevent the update.
3f7692b0ff13 hooks: add preupdate and update hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2211 diff changeset	279 Changeset ID of first new parent is in $HG_PARENT1. If merge, ID
3f7692b0ff13 hooks: add preupdate and update hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2211 diff changeset	280 of second new parent is in $HG_PARENT2.
1720 55017891051b add pretag and tag hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1714 diff changeset	281 tag;;
1727 019e6a47a53e fix names of parent changeset ids in hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1726 diff changeset	282 Run after a tag is created. ID of tagged changeset is in
019e6a47a53e fix names of parent changeset ids in hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1726 diff changeset	283 $HG_NODE. Name of tag is in $HG_TAG. Tag is local if
019e6a47a53e fix names of parent changeset ids in hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1726 diff changeset	284 $HG_LOCAL=1, in repo if $HG_LOCAL=0.
2266 3f7692b0ff13 hooks: add preupdate and update hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2211 diff changeset	285 update;;
3f7692b0ff13 hooks: add preupdate and update hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2211 diff changeset	286 Run after updating the working directory. Changeset ID of first
3f7692b0ff13 hooks: add preupdate and update hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2211 diff changeset	287 new parent is in $HG_PARENT1. If merge, ID of second new parent
3f7692b0ff13 hooks: add preupdate and update hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2211 diff changeset	288 is in $HG_PARENT2. If update succeeded, $HG_ERROR=0. If update
3f7692b0ff13 hooks: add preupdate and update hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2211 diff changeset	289 failed (e.g. because conflicts not resolved), $HG_ERROR=1.
1726 56fb048b102c prefix hook env var names with HG_. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1721 diff changeset	290
2288 dfa17bd1d45e remove non-prefixed environment variables from hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2277 diff changeset	291 Note: In earlier releases, the names of hook environment variables
dfa17bd1d45e remove non-prefixed environment variables from hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2277 diff changeset	292 did not have a "HG_" prefix. The old unprefixed names are no longer
dfa17bd1d45e remove non-prefixed environment variables from hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2277 diff changeset	293 provided in the environment.
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	294
2155 ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	295 The syntax for Python hooks is as follows:
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	296
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	297 hookname = python:modulename.submodule.callable
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	298
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	299 Python hooks are run within the Mercurial process. Each hook is
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	300 called with at least three keyword arguments: a ui object (keyword
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	301 "ui"), a repository object (keyword "repo"), and a "hooktype"
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	302 keyword that tells what kind of hook is used. Arguments listed as
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	303 environment variables above are passed as keyword arguments, with no
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	304 "HG_" prefix, and names in lower case.
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	305
3616 cf001fb04109 Corrected documentation for return value of python hooks. Thomas Arendsen Hein <thomas@intevation.de> parents: 3538 diff changeset	306 If a Python hook returns a "true" value or raises an exception, this
cf001fb04109 Corrected documentation for return value of python hooks. Thomas Arendsen Hein <thomas@intevation.de> parents: 3538 diff changeset	307 is treated as failure of the hook.
2155 ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	308
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	309 http_proxy::
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	310 Used to access web-based Mercurial repositories through a HTTP
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	311 proxy.
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	312 host;;
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	313 Host name and (optional) port of the proxy server, for example
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	314 "myproxy:8000".
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	315 no;;
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	316 Optional. Comma-separated list of host names that should bypass
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	317 the proxy.
1171 a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	318 passwd;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	319 Optional. Password to authenticate with at the proxy server.
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	320 user;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	321 Optional. User name to authenticate with at the proxy server.
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	322
2200 9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	323 smtp::
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	324 Configuration for extensions that need to send email messages.
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	325 host;;
2841 619f1c65384c Adjusted documentation for hgrc's "[smtp] host" for change in 9f745d3675d4. Thomas Arendsen Hein <thomas@intevation.de> parents: 2691 diff changeset	326 Host name of mail server, e.g. "mail.example.com".
2200 9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	327 port;;
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	328 Optional. Port to connect to on mail server. Default: 25.
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	329 tls;;
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	330 Optional. Whether to connect to mail server using TLS. True or
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	331 False. Default: False.
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	332 username;;
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	333 Optional. User name to authenticate to SMTP server with.
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	334 If username is specified, password must also be specified.
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	335 Default: none.
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	336 password;;
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	337 Optional. Password to authenticate to SMTP server with.
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	338 If username is specified, password must also be specified.
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	339 Default: none.
2583 6e5427447f4c adding local_hostname option to smtp configuration Valentino Volonghi aka dialtone <dialtone@divmod.com> parents: 2466 diff changeset	340 local_hostname;;
6e5427447f4c adding local_hostname option to smtp configuration Valentino Volonghi aka dialtone <dialtone@divmod.com> parents: 2466 diff changeset	341 Optional. It's the hostname that the sender can use to identify itself
6e5427447f4c adding local_hostname option to smtp configuration Valentino Volonghi aka dialtone <dialtone@divmod.com> parents: 2466 diff changeset	342 to the MTA.
2200 9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	343
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	344 paths::
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	345 Assigns symbolic names to repositories. The left side is the
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	346 symbolic name, and the right gives the directory or URL that is the
2277 066d0055e430 Add more specific documentation about defaults for the [paths] section Daniel <byteshack@gmail.com> parents: 2266 diff changeset	347 location of the repository. Default paths can be declared by
2621 5a5852a417b1 clone: disable stream support on server side by default. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2583 diff changeset	348 setting the following entries.
2277 066d0055e430 Add more specific documentation about defaults for the [paths] section Daniel <byteshack@gmail.com> parents: 2266 diff changeset	349 default;;
066d0055e430 Add more specific documentation about defaults for the [paths] section Daniel <byteshack@gmail.com> parents: 2266 diff changeset	350 Directory or URL to use when pulling if no source is specified.
066d0055e430 Add more specific documentation about defaults for the [paths] section Daniel <byteshack@gmail.com> parents: 2266 diff changeset	351 Default is set to repository from which the current repository
066d0055e430 Add more specific documentation about defaults for the [paths] section Daniel <byteshack@gmail.com> parents: 2266 diff changeset	352 was cloned.
066d0055e430 Add more specific documentation about defaults for the [paths] section Daniel <byteshack@gmail.com> parents: 2266 diff changeset	353 default-push;;
066d0055e430 Add more specific documentation about defaults for the [paths] section Daniel <byteshack@gmail.com> parents: 2266 diff changeset	354 Optional. Directory or URL to use when pushing if no destination
066d0055e430 Add more specific documentation about defaults for the [paths] section Daniel <byteshack@gmail.com> parents: 2266 diff changeset	355 is specified.
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	356
2621 5a5852a417b1 clone: disable stream support on server side by default. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2583 diff changeset	357 server::
5a5852a417b1 clone: disable stream support on server side by default. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2583 diff changeset	358 Controls generic server settings.
2622 064aef9162cc rename stream hgrc option to compressed. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2621 diff changeset	359 uncompressed;;
2621 5a5852a417b1 clone: disable stream support on server side by default. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2583 diff changeset	360 Whether to allow clients to clone a repo using the uncompressed
5a5852a417b1 clone: disable stream support on server side by default. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2583 diff changeset	361 streaming protocol. This transfers about 40% more data than a
5a5852a417b1 clone: disable stream support on server side by default. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2583 diff changeset	362 regular clone, but uses less memory and CPU on both server and
5a5852a417b1 clone: disable stream support on server side by default. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2583 diff changeset	363 client. Over a LAN (100Mbps or better) or a very fast WAN, an
5a5852a417b1 clone: disable stream support on server side by default. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2583 diff changeset	364 uncompressed streaming clone is a lot faster (~10x) than a regular
5a5852a417b1 clone: disable stream support on server side by default. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2583 diff changeset	365 clone. Over most WAN connections (anything slower than about
5a5852a417b1 clone: disable stream support on server side by default. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2583 diff changeset	366 6Mbps), uncompressed streaming is slower, because of the extra
5a5852a417b1 clone: disable stream support on server side by default. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2583 diff changeset	367 data transfer overhead. Default is False.
5a5852a417b1 clone: disable stream support on server side by default. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2583 diff changeset	368
3537 3b07e223534b Only read .hg/hgrc files from trusted users/groups Alexis S. L. Carvalho <alexis@cecm.usp.br> parents: 3484 diff changeset	369 trusted::
3538 9b52239dc740 save settings from untrusted config files in a separate configparser Alexis S. L. Carvalho <alexis@cecm.usp.br> parents: 3537 diff changeset	370 For security reasons, Mercurial will not use the settings in
9b52239dc740 save settings from untrusted config files in a separate configparser Alexis S. L. Carvalho <alexis@cecm.usp.br> parents: 3537 diff changeset	371 the .hg/hgrc file from a repository if it doesn't belong to a
9b52239dc740 save settings from untrusted config files in a separate configparser Alexis S. L. Carvalho <alexis@cecm.usp.br> parents: 3537 diff changeset	372 trusted user or to a trusted group. The main exception is the
9b52239dc740 save settings from untrusted config files in a separate configparser Alexis S. L. Carvalho <alexis@cecm.usp.br> parents: 3537 diff changeset	373 web interface, which automatically uses some safe settings, since
9b52239dc740 save settings from untrusted config files in a separate configparser Alexis S. L. Carvalho <alexis@cecm.usp.br> parents: 3537 diff changeset	374 it's common to serve repositories from different users.
9b52239dc740 save settings from untrusted config files in a separate configparser Alexis S. L. Carvalho <alexis@cecm.usp.br> parents: 3537 diff changeset	375
9b52239dc740 save settings from untrusted config files in a separate configparser Alexis S. L. Carvalho <alexis@cecm.usp.br> parents: 3537 diff changeset	376 This section specifies what users and groups are trusted. The
9b52239dc740 save settings from untrusted config files in a separate configparser Alexis S. L. Carvalho <alexis@cecm.usp.br> parents: 3537 diff changeset	377 current user is always trusted. To trust everybody, list a user
9b52239dc740 save settings from untrusted config files in a separate configparser Alexis S. L. Carvalho <alexis@cecm.usp.br> parents: 3537 diff changeset	378 or a group with name "*".
9b52239dc740 save settings from untrusted config files in a separate configparser Alexis S. L. Carvalho <alexis@cecm.usp.br> parents: 3537 diff changeset	379
3537 3b07e223534b Only read .hg/hgrc files from trusted users/groups Alexis S. L. Carvalho <alexis@cecm.usp.br> parents: 3484 diff changeset	380 users;;
3b07e223534b Only read .hg/hgrc files from trusted users/groups Alexis S. L. Carvalho <alexis@cecm.usp.br> parents: 3484 diff changeset	381 Comma-separated list of trusted users.
3b07e223534b Only read .hg/hgrc files from trusted users/groups Alexis S. L. Carvalho <alexis@cecm.usp.br> parents: 3484 diff changeset	382 groups;;
3b07e223534b Only read .hg/hgrc files from trusted users/groups Alexis S. L. Carvalho <alexis@cecm.usp.br> parents: 3484 diff changeset	383 Comma-separated list of trusted groups.
3b07e223534b Only read .hg/hgrc files from trusted users/groups Alexis S. L. Carvalho <alexis@cecm.usp.br> parents: 3484 diff changeset	384
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	385 ui::
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	386 User interface controls.
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	387 debug;;
702 a1099c50a622 Fix default values and add interactive setting to [ui] section of hgrc docs. Thomas Arendsen Hein <thomas@intevation.de> parents: 671 diff changeset	388 Print debugging information. True or False. Default is False.
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	389 editor;;
702 a1099c50a622 Fix default values and add interactive setting to [ui] section of hgrc docs. Thomas Arendsen Hein <thomas@intevation.de> parents: 671 diff changeset	390 The editor to use during a commit. Default is $EDITOR or "vi".
2003 62647394e368 Implementation of per-user .hgignore. mcmillen@cs.cmu.edu parents: 1985 diff changeset	391 ignore;;
62647394e368 Implementation of per-user .hgignore. mcmillen@cs.cmu.edu parents: 1985 diff changeset	392 A file to read per-user ignore patterns from. This file should be in
62647394e368 Implementation of per-user .hgignore. mcmillen@cs.cmu.edu parents: 1985 diff changeset	393 the same format as a repository-wide .hgignore file. This option
62647394e368 Implementation of per-user .hgignore. mcmillen@cs.cmu.edu parents: 1985 diff changeset	394 supports hook syntax, so if you want to specify multiple ignore
62647394e368 Implementation of per-user .hgignore. mcmillen@cs.cmu.edu parents: 1985 diff changeset	395 files, you can do so by setting something like
2209 956e329f9e13 document hgignore syntax in new file doc/hgignore.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2200 diff changeset	396 "ignore.other = ~/.hgignore2". For details of the ignore file
956e329f9e13 document hgignore syntax in new file doc/hgignore.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2200 diff changeset	397 format, see the hgignore(5) man page.
702 a1099c50a622 Fix default values and add interactive setting to [ui] section of hgrc docs. Thomas Arendsen Hein <thomas@intevation.de> parents: 671 diff changeset	398 interactive;;
a1099c50a622 Fix default values and add interactive setting to [ui] section of hgrc docs. Thomas Arendsen Hein <thomas@intevation.de> parents: 671 diff changeset	399 Allow to prompt the user. True or False. Default is True.
1907 7718885070b1 let commands that show changesets use templates. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1788 diff changeset	400 logtemplate;;
7718885070b1 let commands that show changesets use templates. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1788 diff changeset	401 Template string for commands that print changesets.
1914 a5bf0030df5f make --style=compact look for map-cmdline.compact. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1907 diff changeset	402 style;;
a5bf0030df5f make --style=compact look for map-cmdline.compact. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1907 diff changeset	403 Name of style to use for command output.
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	404 merge;;
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	405 The conflict resolution program to use during a manual merge.
702 a1099c50a622 Fix default values and add interactive setting to [ui] section of hgrc docs. Thomas Arendsen Hein <thomas@intevation.de> parents: 671 diff changeset	406 Default is "hgmerge".
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	407 quiet;;
702 a1099c50a622 Fix default values and add interactive setting to [ui] section of hgrc docs. Thomas Arendsen Hein <thomas@intevation.de> parents: 671 diff changeset	408 Reduce the amount of output printed. True or False. Default is False.
1171 a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	409 remotecmd;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	410 remote command to use for clone/push/pull operations. Default is 'hg'.
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	411 ssh;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	412 command to use for SSH connections. Default is 'ssh'.
2971 63c3a1921a67 Add ui.strict config item. Bryan O'Sullivan <bos@serpentine.com> parents: 2841 diff changeset	413 strict;;
63c3a1921a67 Add ui.strict config item. Bryan O'Sullivan <bos@serpentine.com> parents: 2841 diff changeset	414 Require exact command names, instead of allowing unambiguous
63c3a1921a67 Add ui.strict config item. Bryan O'Sullivan <bos@serpentine.com> parents: 2841 diff changeset	415 abbreviations. True or False. Default is False.
1787 e431344e604c add a timeout when a lock is held (default 1024 sec) Benoit Boissinot <benoit.boissinot@ens-lyon.org> parents: 1736 diff changeset	416 timeout;;
e431344e604c add a timeout when a lock is held (default 1024 sec) Benoit Boissinot <benoit.boissinot@ens-lyon.org> parents: 1736 diff changeset	417 The timeout used when a lock is held (in seconds), a negative value
1788 750b9cd83965 change the default timeout to 600 seconds Benoit Boissinot <benoit.boissinot@ens-lyon.org> parents: 1787 diff changeset	418 means no timeout. Default is 600.
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	419 username;;
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	420 The committer of a changeset created when running "commit".
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	421 Typically a person's name and email address, e.g. "Fred Widget
3484 c3345b0f2fcd Commit username: Better error message, abort on empty name, fix documentation. Thomas Arendsen Hein <thomas@intevation.de> parents: 3461 diff changeset	422 <fred@example.com>". Default is $EMAIL. If no default is found, or the
c3345b0f2fcd Commit username: Better error message, abort on empty name, fix documentation. Thomas Arendsen Hein <thomas@intevation.de> parents: 3461 diff changeset	423 configured username is empty, it has to be specified manually.
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	424 verbose;;
702 a1099c50a622 Fix default values and add interactive setting to [ui] section of hgrc docs. Thomas Arendsen Hein <thomas@intevation.de> parents: 671 diff changeset	425 Increase the amount of output printed. True or False. Default is False.
962 5730e90c025b Doc updates for push, pull, hooks, local tags, and ssh options mpm@selenic.com parents: 953 diff changeset	426
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	427
938 54b2a42e501e hgweb: add [web] section to hgrc mpm@selenic.com parents: 705 diff changeset	428 web::
54b2a42e501e hgweb: add [web] section to hgrc mpm@selenic.com parents: 705 diff changeset	429 Web interface configuration.
54b2a42e501e hgweb: add [web] section to hgrc mpm@selenic.com parents: 705 diff changeset	430 accesslog;;
54b2a42e501e hgweb: add [web] section to hgrc mpm@selenic.com parents: 705 diff changeset	431 Where to output the access log. Default is stdout.
1171 a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	432 address;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	433 Interface address to bind to. Default is all.
2358 8819fc1dcf4b hgweb: add allow_archive support to [web] section of hgrc TK Soh <teekaysoh@yahoo.com> parents: 2318 diff changeset	434 allow_archive;;
8819fc1dcf4b hgweb: add allow_archive support to [web] section of hgrc TK Soh <teekaysoh@yahoo.com> parents: 2318 diff changeset	435 List of archive format (bz2, gz, zip) allowed for downloading.
8819fc1dcf4b hgweb: add allow_archive support to [web] section of hgrc TK Soh <teekaysoh@yahoo.com> parents: 2318 diff changeset	436 Default is empty.
1171 a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	437 allowbz2;;
2358 8819fc1dcf4b hgweb: add allow_archive support to [web] section of hgrc TK Soh <teekaysoh@yahoo.com> parents: 2318 diff changeset	438 (DEPRECATED) Whether to allow .tar.bz2 downloading of repo revisions.
8819fc1dcf4b hgweb: add allow_archive support to [web] section of hgrc TK Soh <teekaysoh@yahoo.com> parents: 2318 diff changeset	439 Default is false.
1171 a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	440 allowgz;;
2358 8819fc1dcf4b hgweb: add allow_archive support to [web] section of hgrc TK Soh <teekaysoh@yahoo.com> parents: 2318 diff changeset	441 (DEPRECATED) Whether to allow .tar.gz downloading of repo revisions.
8819fc1dcf4b hgweb: add allow_archive support to [web] section of hgrc TK Soh <teekaysoh@yahoo.com> parents: 2318 diff changeset	442 Default is false.
964 3f37720e7dc7 hgweb: Make maxfiles, maxchanges, and allowpull proper config options mpm@selenic.com parents: 962 diff changeset	443 allowpull;;
3f37720e7dc7 hgweb: Make maxfiles, maxchanges, and allowpull proper config options mpm@selenic.com parents: 962 diff changeset	444 Whether to allow pulling from the repository. Default is true.
2466 e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	445 allow_push;;
e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	446 Whether to allow pushing to the repository. If empty or not set,
e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	447 push is not allowed. If the special value "*", any remote user
e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	448 can push, including unauthenticated users. Otherwise, the remote
e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	449 user must have been authenticated, and the authenticated user name
e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	450 must be present in this list (separated by whitespace or ",").
e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	451 The contents of the allow_push list are examined after the
e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	452 deny_push list.
1079 a37974035f1f Document archive download options mpm@selenic.com parents: 986 diff changeset	453 allowzip;;
2358 8819fc1dcf4b hgweb: add allow_archive support to [web] section of hgrc TK Soh <teekaysoh@yahoo.com> parents: 2318 diff changeset	454 (DEPRECATED) Whether to allow .zip downloading of repo revisions.
8819fc1dcf4b hgweb: add allow_archive support to [web] section of hgrc TK Soh <teekaysoh@yahoo.com> parents: 2318 diff changeset	455 Default is false. This feature creates temporary files.
2197 5de8b44f0446 define standard name for base url to use when printing hgweb urls. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2155 diff changeset	456 baseurl;;
5de8b44f0446 define standard name for base url to use when printing hgweb urls. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2155 diff changeset	457 Base URL to use when publishing URLs in other locations, so
5de8b44f0446 define standard name for base url to use when printing hgweb urls. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2155 diff changeset	458 third-party tools like email notification hooks can construct URLs.
5de8b44f0446 define standard name for base url to use when printing hgweb urls. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2155 diff changeset	459 Example: "http://hgserver/repos/"
2430 4ccd71b83d5e Add web.contact to the hgrc documentation. "Daniel Santa Cruz <byteshack@gmail.com>" parents: 2387 diff changeset	460 contact;;
4ccd71b83d5e Add web.contact to the hgrc documentation. "Daniel Santa Cruz <byteshack@gmail.com>" parents: 2387 diff changeset	461 Name or email address of the person in charge of the repository.
4ccd71b83d5e Add web.contact to the hgrc documentation. "Daniel Santa Cruz <byteshack@gmail.com>" parents: 2387 diff changeset	462 Default is "unknown".
2466 e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	463 deny_push;;
e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	464 Whether to deny pushing to the repository. If empty or not set,
e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	465 push is not denied. If the special value "*", all remote users
e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	466 are denied push. Otherwise, unauthenticated users are all denied,
e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	467 and any authenticated user name present in this list (separated by
e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	468 whitespace or ",") is also denied. The contents of the deny_push
e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	469 list are examined before the allow_push list.
1171 a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	470 description;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	471 Textual description of the repository's purpose or contents.
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	472 Default is "unknown".
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	473 errorlog;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	474 Where to output the error log. Default is stderr.
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	475 ipv6;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	476 Whether to use IPv6. Default is false.
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	477 name;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	478 Repository name to use in the web interface. Default is current
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	479 working directory.
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	480 maxchanges;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	481 Maximum number of changes to list on the changelog. Default is 10.
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	482 maxfiles;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	483 Maximum number of files to list per changeset. Default is 10.
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	484 port;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	485 Port to listen on. Default is 8000.
2466 e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	486 push_ssl;;
e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	487 Whether to require that inbound pushes be transported over SSL to
e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	488 prevent password sniffing. Default is true.
2666 ebf033bc8eb2 hgweb: Configurable zebra stripes Frank Kingswood <frank@kingswood-consulting.co.uk> parents: 2622 diff changeset	489 stripes;;
ebf033bc8eb2 hgweb: Configurable zebra stripes Frank Kingswood <frank@kingswood-consulting.co.uk> parents: 2622 diff changeset	490 How many lines a "zebra stripe" should span in multiline output.
ebf033bc8eb2 hgweb: Configurable zebra stripes Frank Kingswood <frank@kingswood-consulting.co.uk> parents: 2622 diff changeset	491 Default is 1; set to 0 to disable.
1171 a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	492 style;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	493 Which template map style to use.
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	494 templates;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	495 Where to find the HTML templates. Default is install path.
1079 a37974035f1f Document archive download options mpm@selenic.com parents: 986 diff changeset	496
938 54b2a42e501e hgweb: add [web] section to hgrc mpm@selenic.com parents: 705 diff changeset	497
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	498 AUTHOR
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	499 ------
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	500 Bryan O'Sullivan <bos@serpentine.com>.
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	501
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	502 Mercurial was written by Matt Mackall <mpm@selenic.com>.
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	503
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	504 SEE ALSO
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	505 --------
2209 956e329f9e13 document hgignore syntax in new file doc/hgignore.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2200 diff changeset	506 hg(1), hgignore(5)
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	507
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	508 COPYING
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	509 -------
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	510 This manual page is copyright 2005 Bryan O'Sullivan.
2209 956e329f9e13 document hgignore syntax in new file doc/hgignore.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2200 diff changeset	511 Mercurial is copyright 2005, 2006 Matt Mackall.
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	512 Free use of this software is granted under the terms of the GNU General
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	513 Public License (GPL).

Mercurial > hg > mercurial-crew-with-dirclash

annotate doc/hgrc.5.txt @ 3685:193e9c6d1a6d