##// END OF EJS Templates
help: use OS containers for config file lists
Matt Mackall -
r22586:6e5657ce default
parent child Browse files
Show More
@@ -28,68 +28,80 b' alphabetical order, later ones overridin'
28 paths are given below, settings from earlier paths override later
28 paths are given below, settings from earlier paths override later
29 ones.
29 ones.
30
30
31 | (All) ``<repo>/.hg/hgrc``
31 .. container:: verbose.unix
32
32
33 Per-repository configuration options that only apply in a
33 On Unix, the following files are consulted:
34 particular repository. This file is not version-controlled, and
35 will not get transferred during a "clone" operation. Options in
36 this file override options in all other configuration files. On
37 Plan 9 and Unix, most of this file will be ignored if it doesn't
38 belong to a trusted user or to a trusted group. See the documentation
39 for the ``[trusted]`` section below for more details.
40
34
41 | (Plan 9) ``$home/lib/hgrc``
35 - ``<repo>/.hg/hgrc`` (per-repository)
42 | (Unix) ``$HOME/.hgrc``
36 - ``$HOME/.hgrc`` (per-user)
43 | (Windows) ``%USERPROFILE%\.hgrc``
37 - ``<install-root>/etc/mercurial/hgrc`` (per-installation)
44 | (Windows) ``%USERPROFILE%\Mercurial.ini``
38 - ``<install-root>/etc/mercurial/hgrc.d/*.rc`` (per-installation)
45 | (Windows) ``%HOME%\.hgrc``
39 - ``/etc/mercurial/hgrc`` (per-system)
46 | (Windows) ``%HOME%\Mercurial.ini``
40 - ``/etc/mercurial/hgrc.d/*.rc`` (per-system)
47
41
48 Per-user configuration file(s), for the user running Mercurial. On
42 .. container:: verbose.windows
49 Windows 9x, ``%HOME%`` is replaced by ``%APPDATA%``. Options in these
50 files apply to all Mercurial commands executed by this user in any
51 directory. Options in these files override per-system and per-installation
52 options.
53
54 | (Plan 9) ``/lib/mercurial/hgrc``
55 | (Plan 9) ``/lib/mercurial/hgrc.d/*.rc``
56 | (Unix) ``/etc/mercurial/hgrc``
57 | (Unix) ``/etc/mercurial/hgrc.d/*.rc``
58
43
59 Per-system configuration files, for the system on which Mercurial
44 On Windows, the following files are consulted:
60 is running. Options in these files apply to all Mercurial commands
61 executed by any user in any directory. Options in these files
62 override per-installation options.
63
64 | (Plan 9) ``<install-root>/lib/mercurial/hgrc``
65 | (Plan 9) ``<install-root>/lib/mercurial/hgrc.d/*.rc``
66 | (Unix) ``<install-root>/etc/mercurial/hgrc``
67 | (Unix) ``<install-root>/etc/mercurial/hgrc.d/*.rc``
68
45
69 Per-installation configuration files, searched for in the
46 - ``<repo>/.hg/hgrc`` (per-repository)
70 directory where Mercurial is installed. ``<install-root>`` is the
47 - ``%USERPROFILE%\.hgrc`` (per-user)
71 parent directory of the **hg** executable (or symlink) being run. For
48 - ``%USERPROFILE%\Mercurial.ini`` (per-user)
72 example, if installed in ``/shared/tools/bin/hg``, Mercurial will look
49 - ``%HOME%\.hgrc`` (per-user)
73 in ``/shared/tools/etc/mercurial/hgrc``. Options in these files apply
50 - ``%HOME%\Mercurial.ini`` (per-user)
74 to all Mercurial commands executed by any user in any directory.
51 - ``<install-dir>\Mercurial.ini`` (per-installation)
52 - ``<install-dir>\hgrc.d\*.rc`` (per-installation)
53 - ``HKEY_LOCAL_MACHINE\SOFTWARE\Mercurial`` (per-installation)
75
54
76 | (Windows) ``<install-dir>\Mercurial.ini`` **or**
55 .. note::
77 | (Windows) ``<install-dir>\hgrc.d\*.rc`` **or**
78 | (Windows) ``HKEY_LOCAL_MACHINE\SOFTWARE\Mercurial``
79
80 Per-installation/system configuration files, for the system on
81 which Mercurial is running. Options in these files apply to all
82 Mercurial commands executed by any user in any directory. Registry
83 keys contain PATH-like strings, every part of which must reference
84 a ``Mercurial.ini`` file or be a directory where ``*.rc`` files will
85 be read. Mercurial checks each of these locations in the specified
86 order until one or more configuration files are detected.
87
88 .. note::
89
56
90 The registry key ``HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Mercurial``
57 The registry key ``HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Mercurial``
91 is used when running 32-bit Python on 64-bit Windows.
58 is used when running 32-bit Python on 64-bit Windows.
92
59
60 .. container:: verbose.plan9
61
62 On Plan9, the following files are consulted:
63
64 - ``<repo>/.hg/hgrc`` (per-repository)
65 - ``$home/lib/hgrc`` (per-user)
66 - ``<install-root>/lib/mercurial/hgrc`` (per-installation)
67 - ``<install-root>/lib/mercurial/hgrc.d/*.rc`` (per-installation)
68 - ``/lib/mercurial/hgrc`` (per-system)
69 - ``/lib/mercurial/hgrc.d/*.rc`` (per-system)
70
71 Per-repository configuration options only apply in a
72 particular repository. This file is not version-controlled, and
73 will not get transferred during a "clone" operation. Options in
74 this file override options in all other configuration files. On
75 Plan 9 and Unix, most of this file will be ignored if it doesn't
76 belong to a trusted user or to a trusted group. See the documentation
77 for the ``[trusted]`` section below for more details.
78
79 Per-user configuration file(s) are for the user running Mercurial. On
80 Windows 9x, ``%HOME%`` is replaced by ``%APPDATA%``. Options in these
81 files apply to all Mercurial commands executed by this user in any
82 directory. Options in these files override per-system and per-installation
83 options.
84
85 Per-installation configuration files are searched for in the
86 directory where Mercurial is installed. ``<install-root>`` is the
87 parent directory of the **hg** executable (or symlink) being run. For
88 example, if installed in ``/shared/tools/bin/hg``, Mercurial will look
89 in ``/shared/tools/etc/mercurial/hgrc``. Options in these files apply
90 to all Mercurial commands executed by any user in any directory.
91
92 Per-installation configuration files are for the system on
93 which Mercurial is running. Options in these files apply to all
94 Mercurial commands executed by any user in any directory. Registry
95 keys contain PATH-like strings, every part of which must reference
96 a ``Mercurial.ini`` file or be a directory where ``*.rc`` files will
97 be read. Mercurial checks each of these locations in the specified
98 order until one or more configuration files are detected.
99
100 Per-system configuration files are for the system on which Mercurial
101 is running. Options in these files apply to all Mercurial commands
102 executed by any user in any directory. Options in these files
103 override per-installation options.
104
93 Syntax
105 Syntax
94 ======
106 ======
95
107
General Comments 0
You need to be logged in to leave comments. Login now