comparison doc/hgrc.5.txt @ 1583:32a4e6802864

make mercurial look in more places for config files. now it searches <install dir>/etc/mercurial, /etc/mercurial, and user hgrc. this allows site-wide configuration to be shared over automounted nfs partition, instead of chenging on every system. option of having local configuration on every system remains. old code for searching /etc/mercurial/hgrc.d never worked, this code is tested and works.
author Vadim Gelfer <vadim.gelfer@gmail.com>
date Fri, 04 Nov 2005 11:51:01 -0800
parents 625f3f13d7be
children eabfbd220f39
comparison
equal deleted inserted replaced
1507:cd8fadd8c689 1583:32a4e6802864
13 aspects of its behaviour. 13 aspects of its behaviour.
14 14
15 FILES 15 FILES
16 ----- 16 -----
17 17
18 Mercurial reads configuration data from up to three files, if they 18 Mercurial reads configuration data from several files, if they exist.
19 exist. The names of these files depend on the system on which 19 The names of these files depend on the system on which Mercurial is
20 Mercurial is installed. 20 installed.
21 21
22 (Unix) <install-root>/etc/mercurial/hgrc.d/*.rc::
23 (Unix) <install-root>/etc/mercurial/hgrc::
24 Per-installation configuration files, searched for in the
25 directory where Mercurial is installed. For example, if installed
26 in /shared/tools, Mercurial will look in
27 /shared/tools/etc/mercurial/hgrc. Options in these files apply to
28 all Mercurial commands executed by any user in any directory.
29
30 (Unix) /etc/mercurial/hgrc.d/*.rc::
22 (Unix) /etc/mercurial/hgrc:: 31 (Unix) /etc/mercurial/hgrc::
23 (Windows) C:\Mercurial\Mercurial.ini:: 32 (Windows) C:\Mercurial\Mercurial.ini::
24 Options in this global configuration file apply to all Mercurial 33 Per-system configuration files, for the system on which Mercurial
25 commands executed by any user in any directory. 34 is running. Options in these files apply to all Mercurial
35 commands executed by any user in any directory. Options in these
36 files override per-installation options.
26 37
27 (Unix) $HOME/.hgrc:: 38 (Unix) $HOME/.hgrc::
28 (Windows) C:\Documents and Settings\USERNAME\Mercurial.ini 39 (Windows) C:\Documents and Settings\USERNAME\Mercurial.ini
29 Per-user configuration options that apply to all Mercurial commands, 40 Per-user configuration file, for the user running Mercurial.
30 no matter from which directory they are run. Values in this file 41 Options in this file apply to all Mercurial commands executed by
31 override global settings. 42 any user in any directory. Options in this file override
43 per-installation and per-system options.
32 44
33 (Unix, Windows) <repo>/.hg/hgrc:: 45 (Unix, Windows) <repo>/.hg/hgrc::
34 Per-repository configuration options that only apply in a 46 Per-repository configuration options that only apply in a
35 particular repository. This file is not version-controlled, and 47 particular repository. This file is not version-controlled, and
36 will not get transferred during a "clone" operation. Values in 48 will not get transferred during a "clone" operation. Options in
37 this file override global and per-user settings. 49 this file override options in all other configuration files.
38 50
39 SYNTAX 51 SYNTAX
40 ------ 52 ------
41 53
42 A configuration file consists of sections, led by a "[section]" header 54 A configuration file consists of sections, led by a "[section]" header