comparison doc/hgrc.5.txt @ 11226:b9e89fc5c7f1

doc: document expansion of %include and ui.username
author Martin Geisler <mg@aragost.com>
date Thu, 27 May 2010 10:37:14 +0200
parents e7adcef1504b
children 5f01fd602542
comparison
equal deleted inserted replaced
11225:d6dbd5e4ee72 11226:b9e89fc5c7f1
144 144
145 A line of the form ``%include file`` will include ``file`` into the 145 A line of the form ``%include file`` will include ``file`` into the
146 current configuration file. The inclusion is recursive, which means 146 current configuration file. The inclusion is recursive, which means
147 that included files can include other files. Filenames are relative to 147 that included files can include other files. Filenames are relative to
148 the configuration file in which the ``%include`` directive is found. 148 the configuration file in which the ``%include`` directive is found.
149 Environment variables and ``~user`` constructs are expanded in
150 ``file``. This lets you do something like::
151
152 %include ~/.hgrc.d/$HOST.rc
153
154 to include a different configuration file on each computer you use.
149 155
150 A line with ``%unset name`` will remove ``name`` from the current 156 A line with ``%unset name`` will remove ``name`` from the current
151 section, if it has been set previously. 157 section, if it has been set previously.
152 158
153 The values are either free-form text strings, lists of text strings, 159 The values are either free-form text strings, lists of text strings,
891 The committer of a changeset created when running "commit". 897 The committer of a changeset created when running "commit".
892 Typically a person's name and email address, e.g. ``Fred Widget 898 Typically a person's name and email address, e.g. ``Fred Widget
893 <fred@example.com>``. Default is ``$EMAIL`` or ``username@hostname``. If 899 <fred@example.com>``. Default is ``$EMAIL`` or ``username@hostname``. If
894 the username in hgrc is empty, it has to be specified manually or 900 the username in hgrc is empty, it has to be specified manually or
895 in a different hgrc file (e.g. ``$HOME/.hgrc``, if the admin set 901 in a different hgrc file (e.g. ``$HOME/.hgrc``, if the admin set
896 ``username =`` in the system hgrc). 902 ``username =`` in the system hgrc). Environment variables in the
903 username are expanded.
897 ``verbose`` 904 ``verbose``
898 Increase the amount of output printed. True or False. Default is False. 905 Increase the amount of output printed. True or False. Default is False.
899 906
900 907
901 ``web`` 908 ``web``