doc/hgrc.5.txt
changeset 8899 992ff92a3552
parent 8898 75cc02e7f672
child 8900 589a3d022079
equal deleted inserted replaced
8898:75cc02e7f672 8899:992ff92a3552
    73     trusted section below for more details.
    73     trusted section below for more details.
    74 
    74 
    75 SYNTAX
    75 SYNTAX
    76 ------
    76 ------
    77 
    77 
    78 A configuration file consists of sections, led by a "[section]" header
    78 A configuration file consists of sections, led by a "`[section]`" header
    79 and followed by "name: value" entries; "name=value" is also accepted.
    79 and followed by "`name: value`" entries; "`name=value`" is also accepted.
    80 
    80 
    81     [spam]
    81     [spam]
    82     eggs=ham
    82     eggs=ham
    83     green=
    83     green=
    84        eggs
    84        eggs
    89 Leading whitespace is removed from values. Empty lines are skipped.
    89 Leading whitespace is removed from values. Empty lines are skipped.
    90 
    90 
    91 The optional values can contain format strings which refer to other
    91 The optional values can contain format strings which refer to other
    92 values in the same section, or values in a special DEFAULT section.
    92 values in the same section, or values in a special DEFAULT section.
    93 
    93 
    94 Lines beginning with "#" or ";" are ignored and may be used to provide
    94 Lines beginning with "`#`" or "`;`" are ignored and may be used to provide
    95 comments.
    95 comments.
    96 
    96 
    97 SECTIONS
    97 SECTIONS
    98 --------
    98 --------
    99 
    99 
   329   Mercurial has an extension mechanism for adding new features. To
   329   Mercurial has an extension mechanism for adding new features. To
   330   enable an extension, create an entry for it in this section.
   330   enable an extension, create an entry for it in this section.
   331 +
   331 +
   332 --
   332 --
   333 If you know that the extension is already in Python's search path,
   333 If you know that the extension is already in Python's search path,
   334 you can give the name of the module, followed by "=", with nothing
   334 you can give the name of the module, followed by "`=`", with nothing
   335 after the "=".
   335 after the "`=`".
   336 
   336 
   337 Otherwise, give a name that you choose, followed by "=", followed by
   337 Otherwise, give a name that you choose, followed by "`=`", followed by
   338 the path to the ".py" file (including the file name extension) that
   338 the path to the "`.py`" file (including the file name extension) that
   339 defines the extension.
   339 defines the extension.
   340 
   340 
   341 To explicitly disable an extension that is enabled in an hgrc of
   341 To explicitly disable an extension that is enabled in an hgrc of
   342 broader scope, prepend its path with '!', as in
   342 broader scope, prepend its path with "`!`", as in
   343 'hgext.foo = !/ext/path' or 'hgext.foo = !' when path is not
   343 "`hgext.foo = !/ext/path`" or "`hgext.foo = !`"  when path is not
   344 supplied.
   344 supplied.
   345 
   345 
   346 Example for `~/.hgrc`:
   346 Example for `~/.hgrc`:
   347 
   347 
   348   [extensions]
   348   [extensions]