# HG changeset patch # User Angel Ezquerra # Date 1274804356 -7200 # Node ID 157f9de9ad2a6f147c8ed0f025c931661f315d66 # Parent 1b8aa9ffa7dc3294aae767474bcf92bad63fb492 doc: clarify that keys can be overridden diff -r 1b8aa9ffa7dc -r 157f9de9ad2a doc/hgrc.5.txt --- a/doc/hgrc.5.txt Mon May 24 21:52:33 2010 +0530 +++ b/doc/hgrc.5.txt Tue May 25 18:19:16 2010 +0200 @@ -90,7 +90,8 @@ ------ A configuration file consists of sections, led by a ``[section]`` header -and followed by ``name = value`` entries:: +and followed by ``name = value`` entries (sometimes called +``configuration keys``):: [spam] eggs=ham @@ -102,6 +103,16 @@ removed from values. Empty lines are skipped. Lines beginning with ``#`` or ``;`` are ignored and may be used to provide comments. +Configuration keys can be set multiple times, in which case mercurial +will use the value that was configured last. As an example:: + + [spam] + eggs=large + ham=serrano + eggs=small + +This would set the configuration key named ``eggs`` to ``small``. + A line of the form ``%include file`` will include ``file`` into the current configuration file. The inclusion is recursive, which means that included files can include other files. Filenames are relative to