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

annotate doc/hgrc.5.txt @ 3347:25d270e0b27f

ui.py: untangle updateopts The code in ui.updateopts that handles ui.quiet, ui.verbose and ui.debugflag is too smart, making it somewhat hard to see what are the exact constraints placed on the values of these variables, hiding some buglets. This patch makes these constraints more explicit, fixing these buglets and changing the behaviour slightly. It also adds a test to make sure things work as expected in the future. The buglets: - setting ui.debug = True in a hgrc wouldn't turn on verbose mode - additionally, setting ui.quiet = True or using --quiet would give you a "quiet debug" mode. The behaviour change: - previously, in a hgrc file, ui.quiet wins against ui.verbose (i.e. the final result would be quiet mode), but --verbose wins against --quiet - now ui.quiet nullifies ui.verbose and --verbose nullifies --quiet. As a consequence, using -qv always gives you normal mode (unless debug mode was turned on somewhere)

author	Alexis S. L. Carvalho <alexis@cecm.usp.br>
date	Tue, 10 Oct 2006 18:43:20 -0300
parents	09e8aecd8016
children	8b55c0ba8048

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.
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	53
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	54 SYNTAX
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	55 ------
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 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	58 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	59
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	60 [spam]
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	61 eggs=ham
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	62 green=
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	63 eggs
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	64
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	65 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	66 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	67
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	68 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	69
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	70 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	71 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	72
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	73 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	74 comments.
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 SECTIONS
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	77 --------
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 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	80 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	81 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	82
1308 2073e5a71008 Cleanup of tabs and trailing spaces. Thomas Arendsen Hein <thomas@intevation.de> parents: 1258 diff changeset	83 decode/encode::
1258 1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	84 Filters for transforming files on checkout/checkin. This would
1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	85 typically be used for newline processing or other
1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	86 localization/canonicalization of files.
1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	87
1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	88 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	89 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	90 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	91 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	92 in ".c" anywhere in the repository, use the pattern "**.c".
1258 1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	93
1293 a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	94 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	95 "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	96
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	97 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	98 transformed data on stdout.
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 Pipe example:
1258 1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	101
1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	102 [encode]
1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	103 # uncompress gzip files on checkin to improve delta compression
1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	104 # 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	105 *.gz = pipe: gunzip
1258 1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	106
1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	107 [decode]
1293 a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	108 # 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	109 # can safely omit "pipe:", because it's the default)
1258 1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	110 *.gz = gzip
1945754e466b Add file encoding/decoding support mpm@selenic.com parents: 1171 diff changeset	111
1293 a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	112 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	113 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	114 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	115 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	116 written by the command.
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	117
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	118 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	119 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	120 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	121 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	122 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	123 corrupt the contents of your files.
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	124
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	125 Tempfile example:
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	126
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	127 [encode]
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	128 # 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	129 **.txt = tempfile: dos2unix -n INFILE OUTFILE
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	130
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	131 [decode]
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	132 # 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	133 # them to the working dir
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	134 **.txt = tempfile: unix2dos -n INFILE OUTFILE
a6ffcebd3315 Enhance the file filtering capabilities. Bryan O'Sullivan <bos@serpentine.com> parents: 1258 diff changeset	135
3036 77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	136 defaults::
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	137 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	138 default options/arguments to pass to the specified commands.
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	139
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	140 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	141 'hg status' show only the modified files, by default.
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 [defaults]
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	144 log = -v
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	145 status = -m
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	146
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	147 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	148 defining command defaults. The command defaults will also be
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	149 applied to the aliases of the commands defined.
77637938d43d add document on command defaults TK Soh <teekaysoh@yahoo.com> parents: 3018 diff changeset	150
2200 9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	151 email::
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	152 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	153 from;;
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	154 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	155 of outgoing messages.
2680 d071a9cc2f94 added documentation for to, cc, and bcc addressing Christian Ebert <blacktrash@gmx.net> parents: 2678 diff changeset	156 to;;
2691 accadcb4e4b5 email: reflect that recipients are specified as comma-separated list Christian Ebert <blacktrash@gmx.net> parents: 2680 diff changeset	157 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	158 cc;;
2691 accadcb4e4b5 email: reflect that recipients are specified as comma-separated list Christian Ebert <blacktrash@gmx.net> parents: 2680 diff changeset	159 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	160 email addresses.
2680 d071a9cc2f94 added documentation for to, cc, and bcc addressing Christian Ebert <blacktrash@gmx.net> parents: 2678 diff changeset	161 bcc;;
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 blind carbon copy
accadcb4e4b5 email: reflect that recipients are specified as comma-separated list Christian Ebert <blacktrash@gmx.net> parents: 2680 diff changeset	163 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	164 method;;
903ab41ac7eb allow to send email using sendmail. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2288 diff changeset	165 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	166 "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	167 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	168 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	169 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	170 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	171 sendmail to send messages.
903ab41ac7eb allow to send email using sendmail. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2288 diff changeset	172
903ab41ac7eb allow to send email using sendmail. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2288 diff changeset	173 Email example:
903ab41ac7eb allow to send email using sendmail. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2288 diff changeset	174
903ab41ac7eb allow to send email using sendmail. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2288 diff changeset	175 [email]
903ab41ac7eb allow to send email using sendmail. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2288 diff changeset	176 from = Joseph User <joe.user@example.com>
903ab41ac7eb allow to send email using sendmail. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2288 diff changeset	177 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	178
2211 b8b7a79a4d88 document [extensions] in doc/hgrc.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2209 diff changeset	179 extensions::
b8b7a79a4d88 document [extensions] in doc/hgrc.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2209 diff changeset	180 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	181 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	182
b8b7a79a4d88 document [extensions] in doc/hgrc.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2209 diff changeset	183 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	184 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	185 after the "=".
b8b7a79a4d88 document [extensions] in doc/hgrc.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2209 diff changeset	186
b8b7a79a4d88 document [extensions] in doc/hgrc.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2209 diff changeset	187 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	188 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	189 defines the extension.
b8b7a79a4d88 document [extensions] in doc/hgrc.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2209 diff changeset	190
2387 62ce297f214f Expand '~' in path to extensions. Markus F.X.J. Oberhumer <markus@oberhumer.com> parents: 2358 diff changeset	191 Example for ~/.hgrc:
62ce297f214f Expand '~' in path to extensions. Markus F.X.J. Oberhumer <markus@oberhumer.com> parents: 2358 diff changeset	192
62ce297f214f Expand '~' in path to extensions. Markus F.X.J. Oberhumer <markus@oberhumer.com> parents: 2358 diff changeset	193 [extensions]
62ce297f214f Expand '~' in path to extensions. Markus F.X.J. Oberhumer <markus@oberhumer.com> parents: 2358 diff changeset	194 # (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	195 hgext.mq =
62ce297f214f Expand '~' in path to extensions. Markus F.X.J. Oberhumer <markus@oberhumer.com> parents: 2358 diff changeset	196 # (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	197 myfeature = ~/.hgext/myfeature.py
62ce297f214f Expand '~' in path to extensions. Markus F.X.J. Oberhumer <markus@oberhumer.com> parents: 2358 diff changeset	198
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	199 hooks::
2155 ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	200 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	201 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	202 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	203 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	204 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	205
625f3f13d7be mention running multiple hooks in the doc Benoit Boissinot <benoit.boissinot@ens-lyon.org> parents: 1316 diff changeset	206 Example .hg/hgrc:
625f3f13d7be mention running multiple hooks in the doc Benoit Boissinot <benoit.boissinot@ens-lyon.org> parents: 1316 diff changeset	207
625f3f13d7be mention running multiple hooks in the doc Benoit Boissinot <benoit.boissinot@ens-lyon.org> parents: 1316 diff changeset	208 [hooks]
625f3f13d7be mention running multiple hooks in the doc Benoit Boissinot <benoit.boissinot@ens-lyon.org> parents: 1316 diff changeset	209 # do not use the site-wide hook
1714 eabfbd220f39 fix hgrc doc hook descriptions. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1583 diff changeset	210 incoming =
eabfbd220f39 fix hgrc doc hook descriptions. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1583 diff changeset	211 incoming.email = /my/email/hook
eabfbd220f39 fix hgrc doc hook descriptions. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1583 diff changeset	212 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	213
1727 019e6a47a53e fix names of parent changeset ids in hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1726 diff changeset	214 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	215 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	216 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	217
1171 a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	218 changegroup;;
1730 0f1d2c75db5e add prechangegroup and pretxnchangegroup hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1721 diff changeset	219 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	220 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	221 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	222 commit;;
1714 eabfbd220f39 fix hgrc doc hook descriptions. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1583 diff changeset	223 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	224 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	225 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	226 incoming;;
eabfbd220f39 fix hgrc doc hook descriptions. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1583 diff changeset	227 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	228 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	229 $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	230 outgoing;;
50de0887bbcd add preoutgoing and outgoing hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1734 diff changeset	231 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	232 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	233 $HG_SOURCE; see "preoutgoing" hook for description.
1730 0f1d2c75db5e add prechangegroup and pretxnchangegroup hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1721 diff changeset	234 prechangegroup;;
0f1d2c75db5e add prechangegroup and pretxnchangegroup hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1721 diff changeset	235 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	236 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	237 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	238 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	239 precommit;;
1721 801756d0ca84 add pretxncommit hook. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1720 diff changeset	240 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	241 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	242 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	243 preoutgoing;;
50de0887bbcd add preoutgoing and outgoing hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1734 diff changeset	244 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	245 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	246 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	247 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	248 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	249 $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	250 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	251 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	252 pretag;;
55017891051b add pretag and tag hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1714 diff changeset	253 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	254 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	255 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	256 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	257 pretxnchangegroup;;
0f1d2c75db5e add prechangegroup and pretxnchangegroup hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1721 diff changeset	258 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	259 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	260 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	261 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	262 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	263 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	264 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	265 changes is in $HG_URL.
1721 801756d0ca84 add pretxncommit hook. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1720 diff changeset	266 pretxncommit;;
801756d0ca84 add pretxncommit hook. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1720 diff changeset	267 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	268 committed. Changeset is visible to hook program. This lets you
801756d0ca84 add pretxncommit hook. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1720 diff changeset	269 validate commit message and changes. Exit status 0 allows the
801756d0ca84 add pretxncommit hook. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1720 diff changeset	270 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	271 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	272 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	273 preupdate;;
3f7692b0ff13 hooks: add preupdate and update hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2211 diff changeset	274 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	275 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	276 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	277 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	278 tag;;
1727 019e6a47a53e fix names of parent changeset ids in hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1726 diff changeset	279 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	280 $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	281 $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	282 update;;
3f7692b0ff13 hooks: add preupdate and update hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2211 diff changeset	283 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	284 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	285 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	286 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	287
2288 dfa17bd1d45e remove non-prefixed environment variables from hooks. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2277 diff changeset	288 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	289 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	290 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	291
2155 ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	292 The syntax for Python hooks is as follows:
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	293
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	294 hookname = python:modulename.submodule.callable
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	295
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	296 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	297 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	298 "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	299 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	300 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	301 "HG_" prefix, and names in lower case.
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	302
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	303 A Python hook must return a "true" value to succeed. Returning a
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	304 "false" value or raising an exception is treated as failure of the
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	305 hook.
ff255b41b4aa support hooks written in python. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2003 diff changeset	306
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	307 http_proxy::
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	308 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	309 proxy.
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	310 host;;
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	311 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	312 "myproxy:8000".
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	313 no;;
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	314 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	315 the proxy.
1171 a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	316 passwd;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	317 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	318 user;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	319 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	320
2200 9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	321 smtp::
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	322 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	323 host;;
2841 619f1c65384c Adjusted documentation for hgrc's "[smtp] host" for change in 9f745d3675d4. Thomas Arendsen Hein <thomas@intevation.de> parents: 2691 diff changeset	324 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	325 port;;
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	326 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	327 tls;;
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	328 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	329 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	330 username;;
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	331 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	332 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	333 Default: none.
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	334 password;;
9f43b6e24232 move mail sending code into core, so extensions can share it. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2197 diff changeset	335 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	336 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	337 Default: none.
2583 6e5427447f4c adding local_hostname option to smtp configuration Valentino Volonghi aka dialtone <dialtone@divmod.com> parents: 2466 diff changeset	338 local_hostname;;
6e5427447f4c adding local_hostname option to smtp configuration Valentino Volonghi aka dialtone <dialtone@divmod.com> parents: 2466 diff changeset	339 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	340 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	341
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	342 paths::
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	343 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	344 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	345 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	346 setting the following entries.
2277 066d0055e430 Add more specific documentation about defaults for the [paths] section Daniel <byteshack@gmail.com> parents: 2266 diff changeset	347 default;;
066d0055e430 Add more specific documentation about defaults for the [paths] section Daniel <byteshack@gmail.com> parents: 2266 diff changeset	348 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	349 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	350 was cloned.
066d0055e430 Add more specific documentation about defaults for the [paths] section Daniel <byteshack@gmail.com> parents: 2266 diff changeset	351 default-push;;
066d0055e430 Add more specific documentation about defaults for the [paths] section Daniel <byteshack@gmail.com> parents: 2266 diff changeset	352 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	353 is specified.
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	354
2621 5a5852a417b1 clone: disable stream support on server side by default. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2583 diff changeset	355 server::
5a5852a417b1 clone: disable stream support on server side by default. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2583 diff changeset	356 Controls generic server settings.
2622 064aef9162cc rename stream hgrc option to compressed. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2621 diff changeset	357 uncompressed;;
2621 5a5852a417b1 clone: disable stream support on server side by default. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2583 diff changeset	358 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	359 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	360 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	361 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	362 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	363 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	364 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	365 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	366
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	367 ui::
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	368 User interface controls.
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	369 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	370 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	371 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	372 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	373 ignore;;
62647394e368 Implementation of per-user .hgignore. mcmillen@cs.cmu.edu parents: 1985 diff changeset	374 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	375 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	376 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	377 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	378 "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	379 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	380 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	381 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	382 logtemplate;;
7718885070b1 let commands that show changesets use templates. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1788 diff changeset	383 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	384 style;;
a5bf0030df5f make --style=compact look for map-cmdline.compact. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 1907 diff changeset	385 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	386 merge;;
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	387 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	388 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	389 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	390 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	391 remotecmd;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	392 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	393 ssh;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	394 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	395 strict;;
63c3a1921a67 Add ui.strict config item. Bryan O'Sullivan <bos@serpentine.com> parents: 2841 diff changeset	396 Require exact command names, instead of allowing unambiguous
63c3a1921a67 Add ui.strict config item. Bryan O'Sullivan <bos@serpentine.com> parents: 2841 diff changeset	397 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	398 timeout;;
e431344e604c add a timeout when a lock is held (default 1024 sec) Benoit Boissinot <benoit.boissinot@ens-lyon.org> parents: 1736 diff changeset	399 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	400 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	401 username;;
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	402 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	403 Typically a person's name and email address, e.g. "Fred Widget
1985 c577689006fa Adapted behaviour of ui.username() to documentation and mention it explicitly: Thomas Arendsen Hein <thomas@intevation.de> parents: 1914 diff changeset	404 <fred@example.com>". Default is $EMAIL or username@hostname, unless
c577689006fa Adapted behaviour of ui.username() to documentation and mention it explicitly: Thomas Arendsen Hein <thomas@intevation.de> parents: 1914 diff changeset	405 username is set to an empty string, which enforces specifying the
c577689006fa Adapted behaviour of ui.username() to documentation and mention it explicitly: Thomas Arendsen Hein <thomas@intevation.de> parents: 1914 diff changeset	406 username manually.
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	407 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	408 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	409
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	410
938 54b2a42e501e hgweb: add [web] section to hgrc mpm@selenic.com parents: 705 diff changeset	411 web::
54b2a42e501e hgweb: add [web] section to hgrc mpm@selenic.com parents: 705 diff changeset	412 Web interface configuration.
54b2a42e501e hgweb: add [web] section to hgrc mpm@selenic.com parents: 705 diff changeset	413 accesslog;;
54b2a42e501e hgweb: add [web] section to hgrc mpm@selenic.com parents: 705 diff changeset	414 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	415 address;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	416 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	417 allow_archive;;
8819fc1dcf4b hgweb: add allow_archive support to [web] section of hgrc TK Soh <teekaysoh@yahoo.com> parents: 2318 diff changeset	418 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	419 Default is empty.
1171 a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	420 allowbz2;;
2358 8819fc1dcf4b hgweb: add allow_archive support to [web] section of hgrc TK Soh <teekaysoh@yahoo.com> parents: 2318 diff changeset	421 (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	422 Default is false.
1171 a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	423 allowgz;;
2358 8819fc1dcf4b hgweb: add allow_archive support to [web] section of hgrc TK Soh <teekaysoh@yahoo.com> parents: 2318 diff changeset	424 (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	425 Default is false.
964 3f37720e7dc7 hgweb: Make maxfiles, maxchanges, and allowpull proper config options mpm@selenic.com parents: 962 diff changeset	426 allowpull;;
3f37720e7dc7 hgweb: Make maxfiles, maxchanges, and allowpull proper config options mpm@selenic.com parents: 962 diff changeset	427 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	428 allow_push;;
e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	429 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	430 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	431 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	432 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	433 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	434 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	435 deny_push list.
1079 a37974035f1f Document archive download options mpm@selenic.com parents: 986 diff changeset	436 allowzip;;
2358 8819fc1dcf4b hgweb: add allow_archive support to [web] section of hgrc TK Soh <teekaysoh@yahoo.com> parents: 2318 diff changeset	437 (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	438 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	439 baseurl;;
5de8b44f0446 define standard name for base url to use when printing hgweb urls. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2155 diff changeset	440 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	441 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	442 Example: "http://hgserver/repos/"
2430 4ccd71b83d5e Add web.contact to the hgrc documentation. "Daniel Santa Cruz <byteshack@gmail.com>" parents: 2387 diff changeset	443 contact;;
4ccd71b83d5e Add web.contact to the hgrc documentation. "Daniel Santa Cruz <byteshack@gmail.com>" parents: 2387 diff changeset	444 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	445 Default is "unknown".
2466 e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	446 deny_push;;
e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	447 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	448 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	449 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	450 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	451 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	452 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	453 description;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	454 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	455 Default is "unknown".
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	456 errorlog;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	457 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	458 ipv6;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	459 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	460 name;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	461 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	462 working directory.
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	463 maxchanges;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	464 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	465 maxfiles;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	466 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	467 port;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	468 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	469 push_ssl;;
e10665147d26 push over http: server side authorization support. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2430 diff changeset	470 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	471 prevent password sniffing. Default is true.
2666 ebf033bc8eb2 hgweb: Configurable zebra stripes Frank Kingswood <frank@kingswood-consulting.co.uk> parents: 2622 diff changeset	472 stripes;;
ebf033bc8eb2 hgweb: Configurable zebra stripes Frank Kingswood <frank@kingswood-consulting.co.uk> parents: 2622 diff changeset	473 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	474 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	475 style;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	476 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	477 templates;;
a425bb927ede Sort items in each hgrc section. Add web/description. Bryan O'Sullivan <bos@serpentine.com> parents: 1079 diff changeset	478 Where to find the HTML templates. Default is install path.
1079 a37974035f1f Document archive download options mpm@selenic.com parents: 986 diff changeset	479
938 54b2a42e501e hgweb: add [web] section to hgrc mpm@selenic.com parents: 705 diff changeset	480
671 efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	481 AUTHOR
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	482 ------
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	483 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	484
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	485 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	486
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	487 SEE ALSO
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	488 --------
2209 956e329f9e13 document hgignore syntax in new file doc/hgignore.5.txt. Vadim Gelfer <vadim.gelfer@gmail.com> parents: 2200 diff changeset	489 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	490
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	491 COPYING
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	492 -------
efa4a7e2f322 Move hgrc documentation out to its own man page, hgrc(5). Bryan O'Sullivan <bos@serpentine.com> parents: diff changeset	493 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	494 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	495 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	496 Public License (GPL).

Mercurial > hg > mercurial-crew-with-dirclash

annotate doc/hgrc.5.txt @ 3347:25d270e0b27f