Mercurial > hg
comparison doc/hgrc.5.txt @ 9659:f53c549237ca
hgrc.5.txt: mention hgrc categories with higher precedence first
Reordering the FILES section accordingly.
The previous ordering of categories might have been nice from the
viewpoint of a site admin doing an initial install, but presenting a
higher-precedence-first ordering is more relevant and natural for the
average end user, since he will most likely resort to editing rc files
in the order of their precedence, overriding whatever "sane" defaults
are coming from more general files.
Note that this patch does not change the texts, it just moves them.
So, whatever bugs, grammar errors, or typos may have been in the texts
before this patch: they are still there. On purpose. Because this patch
here does not want to reword texts while moving them.
author | Adrian Buehlmann <adrian@cadifra.com> |
---|---|
date | Wed, 21 Oct 2009 13:40:55 +0200 |
parents | 24dad078603b |
children | 59e5ae188440 |
comparison
equal
deleted
inserted
replaced
9658:852b1f3032d2 | 9659:f53c549237ca |
---|---|
27 | 27 |
28 Mercurial reads configuration data from several files, if they exist. | 28 Mercurial reads configuration data from several files, if they exist. |
29 The names of these files depend on the system on which Mercurial is | 29 The names of these files depend on the system on which Mercurial is |
30 installed. ``*.rc`` files from a single directory are read in | 30 installed. ``*.rc`` files from a single directory are read in |
31 alphabetical order, later ones overriding earlier ones. Where multiple | 31 alphabetical order, later ones overriding earlier ones. Where multiple |
32 paths are given below, settings from later paths override earlier | 32 paths are given below, settings from earlier paths override later |
33 ones. | 33 ones. |
34 | |
35 | (Unix) ``<install-root>/etc/mercurial/hgrc.d/*.rc`` | |
36 | (Unix) ``<install-root>/etc/mercurial/hgrc`` | |
37 | |
38 Per-installation configuration files, searched for in the | |
39 directory where Mercurial is installed. ``<install-root>`` is the | |
40 parent directory of the **hg** executable (or symlink) being run. For | |
41 example, if installed in ``/shared/tools/bin/hg``, Mercurial will look | |
42 in ``/shared/tools/etc/mercurial/hgrc``. Options in these files apply | |
43 to all Mercurial commands executed by any user in any directory. | |
44 | |
45 | (Unix) ``/etc/mercurial/hgrc.d/*.rc`` | |
46 | (Unix) ``/etc/mercurial/hgrc`` | |
47 | |
48 Per-system configuration files, for the system on which Mercurial | |
49 is running. Options in these files apply to all Mercurial commands | |
50 executed by any user in any directory. Options in these files | |
51 override per-installation options. | |
52 | |
53 | (Windows) ``<install-dir>\Mercurial.ini`` or else | |
54 | (Windows) ``HKEY_LOCAL_MACHINE\SOFTWARE\Mercurial`` or else | |
55 | (Windows) ``C:\Mercurial\Mercurial.ini`` | |
56 | |
57 Per-installation/system configuration files, for the system on | |
58 which Mercurial is running. Options in these files apply to all | |
59 Mercurial commands executed by any user in any directory. Registry | |
60 keys contain PATH-like strings, every part of which must reference | |
61 a ``Mercurial.ini`` file or be a directory where ``*.rc`` files will | |
62 be read. | |
63 | |
64 | (Unix) ``$HOME/.hgrc`` | |
65 | (Windows) ``%HOME%\Mercurial.ini`` | |
66 | (Windows) ``%HOME%\.hgrc`` | |
67 | (Windows) ``%USERPROFILE%\Mercurial.ini`` | |
68 | (Windows) ``%USERPROFILE%\.hgrc`` | |
69 | |
70 Per-user configuration file(s), for the user running Mercurial. On | |
71 Windows 9x, ``%HOME%`` is replaced by ``%APPDATA%``. Options in these | |
72 files apply to all Mercurial commands executed by this user in any | |
73 directory. Options in these files override per-installation and | |
74 per-system options. | |
75 | 34 |
76 | (Unix, Windows) ``<repo>/.hg/hgrc`` | 35 | (Unix, Windows) ``<repo>/.hg/hgrc`` |
77 | 36 |
78 Per-repository configuration options that only apply in a | 37 Per-repository configuration options that only apply in a |
79 particular repository. This file is not version-controlled, and | 38 particular repository. This file is not version-controlled, and |
80 will not get transferred during a "clone" operation. Options in | 39 will not get transferred during a "clone" operation. Options in |
81 this file override options in all other configuration files. On | 40 this file override options in all other configuration files. On |
82 Unix, most of this file will be ignored if it doesn't belong to a | 41 Unix, most of this file will be ignored if it doesn't belong to a |
83 trusted user or to a trusted group. See the documentation for the | 42 trusted user or to a trusted group. See the documentation for the |
84 trusted section below for more details. | 43 trusted section below for more details. |
44 | |
45 | (Unix) ``$HOME/.hgrc`` | |
46 | (Windows) ``%USERPROFILE%\.hgrc`` | |
47 | (Windows) ``%USERPROFILE%\Mercurial.ini`` | |
48 | (Windows) ``%HOME%\.hgrc`` | |
49 | (Windows) ``%HOME%\Mercurial.ini`` | |
50 | |
51 Per-user configuration file(s), for the user running Mercurial. On | |
52 Windows 9x, ``%HOME%`` is replaced by ``%APPDATA%``. Options in these | |
53 files apply to all Mercurial commands executed by this user in any | |
54 directory. Options in these files override per-system and per-installation | |
55 options. | |
56 | |
57 | (Unix) ``/etc/mercurial/hgrc`` | |
58 | (Unix) ``/etc/mercurial/hgrc.d/*.rc`` | |
59 | |
60 Per-system configuration files, for the system on which Mercurial | |
61 is running. Options in these files apply to all Mercurial commands | |
62 executed by any user in any directory. Options in these files | |
63 override per-installation options. | |
64 | |
65 | (Unix) ``<install-root>/etc/mercurial/hgrc`` | |
66 | (Unix) ``<install-root>/etc/mercurial/hgrc.d/*.rc`` | |
67 | |
68 Per-installation configuration files, searched for in the | |
69 directory where Mercurial is installed. ``<install-root>`` is the | |
70 parent directory of the **hg** executable (or symlink) being run. For | |
71 example, if installed in ``/shared/tools/bin/hg``, Mercurial will look | |
72 in ``/shared/tools/etc/mercurial/hgrc``. Options in these files apply | |
73 to all Mercurial commands executed by any user in any directory. | |
74 | |
75 | (Windows) ``C:\Mercurial\Mercurial.ini`` | |
76 | (Windows) ``HKEY_LOCAL_MACHINE\SOFTWARE\Mercurial`` | |
77 | (Windows) ``<install-dir>\Mercurial.ini`` | |
78 | |
79 Per-installation/system configuration files, for the system on | |
80 which Mercurial is running. Options in these files apply to all | |
81 Mercurial commands executed by any user in any directory. Registry | |
82 keys contain PATH-like strings, every part of which must reference | |
83 a ``Mercurial.ini`` file or be a directory where ``*.rc`` files will | |
84 be read. | |
85 | 85 |
86 SYNTAX | 86 SYNTAX |
87 ------ | 87 ------ |
88 | 88 |
89 A configuration file consists of sections, led by a ``[section]`` header | 89 A configuration file consists of sections, led by a ``[section]`` header |