config.txt
57 lines
| 2.1 KiB
| text/plain
|
TextLexer
|
r9999 | Mercurial reads configuration data from several files, if they exist. | ||
Below we list the most specific file first. | ||||
On Windows, these configuration files are read: | ||||
- ``<repo>\.hg\hgrc`` | ||||
- ``%USERPROFILE%\.hgrc`` | ||||
|
r11016 | - ``%USERPROFILE%\mercurial.ini`` | ||
|
r9999 | - ``%HOME%\.hgrc`` | ||
|
r11016 | - ``%HOME%\mercurial.ini`` | ||
- ``C:\mercurial\mercurial.ini`` (unless regkey or hgrc.d\ or mercurial.ini found) | ||||
- ``HKEY_LOCAL_MACHINE\SOFTWARE\Mercurial`` (unless hgrc.d\ or mercurial.ini found) | ||||
- ``<hg.exe-dir>\hgrc.d\*.rc`` (unless mercurial.ini found) | ||||
- ``<hg.exe-dir>\mercurial.ini`` | ||||
|
r9999 | |||
On Unix, these files are read: | ||||
- ``<repo>/.hg/hgrc`` | ||||
- ``$HOME/.hgrc`` | ||||
- ``/etc/mercurial/hgrc`` | ||||
- ``/etc/mercurial/hgrc.d/*.rc`` | ||||
- ``<install-root>/etc/mercurial/hgrc`` | ||||
- ``<install-root>/etc/mercurial/hgrc.d/*.rc`` | ||||
|
r13955 | These files do not exist by default and you will have to create the | ||
appropriate configuration files yourself: global configuration like | ||||
the username setting is typically put into | ||||
``%USERPROFILE%\mercurial.ini`` or ``$HOME/.hgrc`` and local | ||||
configuration is put into the per-repository ``<repo>/.hg/hgrc`` file. | ||||
|
r11408 | If there is a per-repository configuration file which is not owned by | ||
the active user, Mercurial will warn you that the file is skipped:: | ||||
not trusting file <repo>/.hg/hgrc from untrusted user USER, group GROUP | ||||
If this bothers you, the warning can be silenced (the file would still | ||||
be ignored) or trust can be established. Use one of the following | ||||
settings, the syntax is explained below: | ||||
- ``ui.report_untrusted = False`` | ||||
- ``trusted.users = USER`` | ||||
- ``trusted.groups = GROUP`` | ||||
|
r9999 | The configuration files for Mercurial use a simple ini-file format. A | ||
configuration file consists of sections, led by a ``[section]`` header | ||||
and followed by ``name = value`` entries:: | ||||
[ui] | ||||
username = Firstname Lastname <firstname.lastname@example.net> | ||||
verbose = True | ||||
|
r10998 | The above entries will be referred to as ``ui.username`` and | ||
|
r9999 | ``ui.verbose``, respectively. Please see the hgrc man page for a full | ||
description of the possible configuration values: | ||||
- on Unix-like systems: ``man hgrc`` | ||||
- online: http://www.selenic.com/mercurial/hgrc.5.html | ||||