# HG changeset patch
# User Martin Geisler <mg@aragost.com>
# Date 1274949434 -7200
# Node ID b9e89fc5c7f11ab8e4a9f74b9c266d8f1d11b91f
# Parent  d6dbd5e4ee7209f6d2b638d08ef9f00a12a652be
doc: document expansion of %include and ui.username

diff -r d6dbd5e4ee72 -r b9e89fc5c7f1 doc/hgrc.5.txt
--- a/doc/hgrc.5.txt	Wed May 26 14:03:29 2010 -0700
+++ b/doc/hgrc.5.txt	Thu May 27 10:37:14 2010 +0200
@@ -146,6 +146,12 @@
 current configuration file. The inclusion is recursive, which means
 that included files can include other files. Filenames are relative to
 the configuration file in which the ``%include`` directive is found.
+Environment variables and ``~user`` constructs are expanded in
+``file``. This lets you do something like::
+
+  %include ~/.hgrc.d/$HOST.rc
+
+to include a different configuration file on each computer you use.
 
 A line with ``%unset name`` will remove ``name`` from the current
 section, if it has been set previously.
@@ -893,7 +899,8 @@
     <fred@example.com>``. Default is ``$EMAIL`` or ``username@hostname``. If
     the username in hgrc is empty, it has to be specified manually or
     in a different hgrc file (e.g. ``$HOME/.hgrc``, if the admin set
-    ``username =``  in the system hgrc).
+    ``username =``  in the system hgrc). Environment variables in the
+    username are expanded.
 ``verbose``
     Increase the amount of output printed. True or False. Default is False.