#pragma section-numbers 2
= hgcfg =
Display or modify local, user, and global configuration.

<<TableOfContents>>

== Status ==
'''This extension is not distributed with Mercurial.'''

''Author: '' ''Brian Mearns''

Repository: ''https://bitbucket.org/bmearns/hgcfg''

Web page: ''https://bitbucket.org/bmearns/hgcfg/''

For detailed documentation, please see the webpage listed above.

== Overview ==
Provides three commands:

 * '''hg cfg''' - Query or configure keys from all relevant configuration files.
 * '''hg listcfgs''' - List all configuration files that are relevant to the current repository.
 * '''hg editcfg''' - Edit a local, user, or global config file using HG's configured EDITOR.

This extension also provides a basic API that other extensions can use to poke around and modify config files, instead of hacking on the text directly.

== Configuration ==
Configure your .hgrc to enable the extension by adding following lines:

{{{
[extensions]
hgcfg = /path/to/hgcfg/hgext/hgcfg.py
}}}
== See also ==
 * ConfigExtension
 * ConfigExtensionCommandLine

----
CategoryExtensionsByOthers