Recently we added .hg/hgrc-not-shared which is a config file which won't be
shared with shares when share-safe mode is enabled. Irrespective of whether
we are using share-safe or not, we consult this file now.
Let's document that.
mharbison72 |
hg-reviewers |
Recently we added .hg/hgrc-not-shared which is a config file which won't be
shared with shares when share-safe mode is enabled. Irrespective of whether
we are using share-safe or not, we consult this file now.
Let's document that.
Automatic diff as part of commit; lint not applicable. |
Automatic diff as part of commit; unit tests not applicable. |
alphabetical order, later ones overriding earlier ones. Where multiple | alphabetical order, later ones overriding earlier ones. Where multiple | ||||
paths are given below, settings from earlier paths override later | paths are given below, settings from earlier paths override later | ||||
ones. | ones. | ||||
.. container:: verbose.unix | .. container:: verbose.unix | ||||
On Unix, the following files are consulted: | On Unix, the following files are consulted: | ||||
- ``<repo>/.hg/hgrc-not-shared`` (per-repository) | |||||
- ``<repo>/.hg/hgrc`` (per-repository) | - ``<repo>/.hg/hgrc`` (per-repository) | ||||
- ``$HOME/.hgrc`` (per-user) | - ``$HOME/.hgrc`` (per-user) | ||||
- ``${XDG_CONFIG_HOME:-$HOME/.config}/hg/hgrc`` (per-user) | - ``${XDG_CONFIG_HOME:-$HOME/.config}/hg/hgrc`` (per-user) | ||||
- ``<install-root>/etc/mercurial/hgrc`` (per-installation) | - ``<install-root>/etc/mercurial/hgrc`` (per-installation) | ||||
- ``<install-root>/etc/mercurial/hgrc.d/*.rc`` (per-installation) | - ``<install-root>/etc/mercurial/hgrc.d/*.rc`` (per-installation) | ||||
- ``/etc/mercurial/hgrc`` (per-system) | - ``/etc/mercurial/hgrc`` (per-system) | ||||
- ``/etc/mercurial/hgrc.d/*.rc`` (per-system) | - ``/etc/mercurial/hgrc.d/*.rc`` (per-system) | ||||
- ``<internal>/*.rc`` (defaults) | - ``<internal>/*.rc`` (defaults) | ||||
.. container:: verbose.windows | .. container:: verbose.windows | ||||
On Windows, the following files are consulted: | On Windows, the following files are consulted: | ||||
- ``<repo>/.hg/hgrc-not-shared`` (per-repository) | |||||
- ``<repo>/.hg/hgrc`` (per-repository) | - ``<repo>/.hg/hgrc`` (per-repository) | ||||
- ``%USERPROFILE%\.hgrc`` (per-user) | - ``%USERPROFILE%\.hgrc`` (per-user) | ||||
- ``%USERPROFILE%\Mercurial.ini`` (per-user) | - ``%USERPROFILE%\Mercurial.ini`` (per-user) | ||||
- ``%HOME%\.hgrc`` (per-user) | - ``%HOME%\.hgrc`` (per-user) | ||||
- ``%HOME%\Mercurial.ini`` (per-user) | - ``%HOME%\Mercurial.ini`` (per-user) | ||||
- ``HKEY_LOCAL_MACHINE\SOFTWARE\Mercurial`` (per-system) | - ``HKEY_LOCAL_MACHINE\SOFTWARE\Mercurial`` (per-system) | ||||
- ``<install-dir>\hgrc.d\*.rc`` (per-installation) | - ``<install-dir>\hgrc.d\*.rc`` (per-installation) | ||||
- ``<install-dir>\Mercurial.ini`` (per-installation) | - ``<install-dir>\Mercurial.ini`` (per-installation) | ||||
- ``%PROGRAMDATA%\Mercurial\hgrc`` (per-system) | - ``%PROGRAMDATA%\Mercurial\hgrc`` (per-system) | ||||
- ``%PROGRAMDATA%\Mercurial\Mercurial.ini`` (per-system) | - ``%PROGRAMDATA%\Mercurial\Mercurial.ini`` (per-system) | ||||
- ``%PROGRAMDATA%\Mercurial\hgrc.d\*.rc`` (per-system) | - ``%PROGRAMDATA%\Mercurial\hgrc.d\*.rc`` (per-system) | ||||
- ``<internal>/*.rc`` (defaults) | - ``<internal>/*.rc`` (defaults) | ||||
.. note:: | .. note:: | ||||
The registry key ``HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Mercurial`` | The registry key ``HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Mercurial`` | ||||
is used when running 32-bit Python on 64-bit Windows. | is used when running 32-bit Python on 64-bit Windows. | ||||
.. container:: verbose.plan9 | .. container:: verbose.plan9 | ||||
On Plan9, the following files are consulted: | On Plan9, the following files are consulted: | ||||
- ``<repo>/.hg/hgrc-not-shared`` (per-repository) | |||||
- ``<repo>/.hg/hgrc`` (per-repository) | - ``<repo>/.hg/hgrc`` (per-repository) | ||||
- ``$home/lib/hgrc`` (per-user) | - ``$home/lib/hgrc`` (per-user) | ||||
- ``<install-root>/lib/mercurial/hgrc`` (per-installation) | - ``<install-root>/lib/mercurial/hgrc`` (per-installation) | ||||
- ``<install-root>/lib/mercurial/hgrc.d/*.rc`` (per-installation) | - ``<install-root>/lib/mercurial/hgrc.d/*.rc`` (per-installation) | ||||
- ``/lib/mercurial/hgrc`` (per-system) | - ``/lib/mercurial/hgrc`` (per-system) | ||||
- ``/lib/mercurial/hgrc.d/*.rc`` (per-system) | - ``/lib/mercurial/hgrc.d/*.rc`` (per-system) | ||||
- ``<internal>/*.rc`` (defaults) | - ``<internal>/*.rc`` (defaults) | ||||