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 |