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 |
|
|
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