# HG changeset patch # User Matt Mackall # Date 1412110530 18000 # Node ID 6e5657ce9e8c330a764f8c5f777237b1eff90967 # Parent 15282c6612fb013140bfe5bc59cb0b5990def558 help: use OS containers for config file lists diff -r 15282c6612fb -r 6e5657ce9e8c mercurial/help/config.txt --- a/mercurial/help/config.txt Tue Sep 30 15:51:22 2014 -0500 +++ b/mercurial/help/config.txt Tue Sep 30 15:55:30 2014 -0500 @@ -28,68 +28,80 @@ paths are given below, settings from earlier paths override later ones. -| (All) ``/.hg/hgrc`` +.. container:: verbose.unix - Per-repository configuration options that only apply in a - particular repository. This file is not version-controlled, and - will not get transferred during a "clone" operation. Options in - this file override options in all other configuration files. On - Plan 9 and Unix, most of this file will be ignored if it doesn't - belong to a trusted user or to a trusted group. See the documentation - for the ``[trusted]`` section below for more details. + On Unix, the following files are consulted: -| (Plan 9) ``$home/lib/hgrc`` -| (Unix) ``$HOME/.hgrc`` -| (Windows) ``%USERPROFILE%\.hgrc`` -| (Windows) ``%USERPROFILE%\Mercurial.ini`` -| (Windows) ``%HOME%\.hgrc`` -| (Windows) ``%HOME%\Mercurial.ini`` + - ``/.hg/hgrc`` (per-repository) + - ``$HOME/.hgrc`` (per-user) + - ``/etc/mercurial/hgrc`` (per-installation) + - ``/etc/mercurial/hgrc.d/*.rc`` (per-installation) + - ``/etc/mercurial/hgrc`` (per-system) + - ``/etc/mercurial/hgrc.d/*.rc`` (per-system) - Per-user configuration file(s), for the user running Mercurial. On - Windows 9x, ``%HOME%`` is replaced by ``%APPDATA%``. Options in these - files apply to all Mercurial commands executed by this user in any - directory. Options in these files override per-system and per-installation - options. - -| (Plan 9) ``/lib/mercurial/hgrc`` -| (Plan 9) ``/lib/mercurial/hgrc.d/*.rc`` -| (Unix) ``/etc/mercurial/hgrc`` -| (Unix) ``/etc/mercurial/hgrc.d/*.rc`` +.. container:: verbose.windows - Per-system configuration files, for the system on which Mercurial - is running. Options in these files apply to all Mercurial commands - executed by any user in any directory. Options in these files - override per-installation options. - -| (Plan 9) ``/lib/mercurial/hgrc`` -| (Plan 9) ``/lib/mercurial/hgrc.d/*.rc`` -| (Unix) ``/etc/mercurial/hgrc`` -| (Unix) ``/etc/mercurial/hgrc.d/*.rc`` + On Windows, the following files are consulted: - Per-installation configuration files, searched for in the - directory where Mercurial is installed. ```` is the - parent directory of the **hg** executable (or symlink) being run. For - example, if installed in ``/shared/tools/bin/hg``, Mercurial will look - in ``/shared/tools/etc/mercurial/hgrc``. Options in these files apply - to all Mercurial commands executed by any user in any directory. + - ``/.hg/hgrc`` (per-repository) + - ``%USERPROFILE%\.hgrc`` (per-user) + - ``%USERPROFILE%\Mercurial.ini`` (per-user) + - ``%HOME%\.hgrc`` (per-user) + - ``%HOME%\Mercurial.ini`` (per-user) + - ``\Mercurial.ini`` (per-installation) + - ``\hgrc.d\*.rc`` (per-installation) + - ``HKEY_LOCAL_MACHINE\SOFTWARE\Mercurial`` (per-installation) -| (Windows) ``\Mercurial.ini`` **or** -| (Windows) ``\hgrc.d\*.rc`` **or** -| (Windows) ``HKEY_LOCAL_MACHINE\SOFTWARE\Mercurial`` - - Per-installation/system configuration files, for the system on - which Mercurial is running. Options in these files apply to all - Mercurial commands executed by any user in any directory. Registry - keys contain PATH-like strings, every part of which must reference - a ``Mercurial.ini`` file or be a directory where ``*.rc`` files will - be read. Mercurial checks each of these locations in the specified - order until one or more configuration files are detected. - -.. note:: + .. note:: The registry key ``HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Mercurial`` is used when running 32-bit Python on 64-bit Windows. +.. container:: verbose.plan9 + + On Plan9, the following files are consulted: + + - ``/.hg/hgrc`` (per-repository) + - ``$home/lib/hgrc`` (per-user) + - ``/lib/mercurial/hgrc`` (per-installation) + - ``/lib/mercurial/hgrc.d/*.rc`` (per-installation) + - ``/lib/mercurial/hgrc`` (per-system) + - ``/lib/mercurial/hgrc.d/*.rc`` (per-system) + +Per-repository configuration options only apply in a +particular repository. This file is not version-controlled, and +will not get transferred during a "clone" operation. Options in +this file override options in all other configuration files. On +Plan 9 and Unix, most of this file will be ignored if it doesn't +belong to a trusted user or to a trusted group. See the documentation +for the ``[trusted]`` section below for more details. + +Per-user configuration file(s) are for the user running Mercurial. On +Windows 9x, ``%HOME%`` is replaced by ``%APPDATA%``. Options in these +files apply to all Mercurial commands executed by this user in any +directory. Options in these files override per-system and per-installation +options. + +Per-installation configuration files are searched for in the +directory where Mercurial is installed. ```` is the +parent directory of the **hg** executable (or symlink) being run. For +example, if installed in ``/shared/tools/bin/hg``, Mercurial will look +in ``/shared/tools/etc/mercurial/hgrc``. Options in these files apply +to all Mercurial commands executed by any user in any directory. + +Per-installation configuration files are for the system on +which Mercurial is running. Options in these files apply to all +Mercurial commands executed by any user in any directory. Registry +keys contain PATH-like strings, every part of which must reference +a ``Mercurial.ini`` file or be a directory where ``*.rc`` files will +be read. Mercurial checks each of these locations in the specified +order until one or more configuration files are detected. + +Per-system configuration files are for the system on which Mercurial +is running. Options in these files apply to all Mercurial commands +executed by any user in any directory. Options in these files +override per-installation options. + Syntax ======