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