|
Size: 3872
Comment: Added ref to HgcfgExtension
|
← Revision 9 as of 2013-11-06 06:10:41 ⇥
Size: 4009
Comment: update wiki post style, add some links
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| == Config Extension == | #pragma section-numbers 2 = Config Extension = |
| Line 10: | Line 11: |
| To use the dialogs, you must have PyQt4 or PyGtk installed. '''This extension is considered defunct, use TortoiseHG config dialogs instead. For command line access to configuration, consider HgcfgExtension.''' | To use the dialogs, you must have [[http://www.riverbankcomputing.com/software/pyqt/intro|PyQt4]] or [[http://www.pygtk.org/|PyGtk]] installed. '''This extension is considered defunct, use TortoiseHg config dialogs instead. For command line access to configuration, consider HgcfgExtension.''' |
| Line 12: | Line 13: |
| === Overview === This extension provides an 'hg config' command which can be used to read or write values from your Mercurial configuration files. It also provides a small number of dialog windows for the most common configuration tasks. |
<<TableOfContents(3)>> |
| Line 15: | Line 15: |
| === Configuration === Configure your .hgrc to enable the extension by adding following lines: |
== Overview == This extension provides an `hg config` command which can be used to read or write values from your Mercurial configuration files. It also provides a small number of dialog windows for the most common configuration tasks. == Configuration == Configure your `.hgrc` to enable the extension by adding following lines: |
| Line 22: | Line 25: |
| Note that the hg-config repository comes with an hgconf.rc file which is intended to be copied into a site-wide hgrc.d/ directory. It enables the extension and configures the username hook (below). | Note that the hg-config repository comes with an `hgconf.rc` file which is intended to be copied into a site-wide `hgrc.d/` directory. It enables the extension and configures the username hook (below). |
| Line 24: | Line 27: |
| === Username Hook === This extension also provides a hook which can spawn the username dialog when a user tries to make a commit without a valid username. It is enabled by adding the following lines to the site-wide hgrc file. |
== Username Hook == This extension also provides a hook which can spawn the username dialog when a user tries to make a commit without a valid username. It is enabled by adding the following lines to the site-wide `hgrc` file. |
| Line 31: | Line 34: |
| After a user triggers the dialog and enters a valid username, the dialog will override the global precommit.username hook by adding the following lines into the same hgrc file the username was stored: | After a user triggers the dialog and enters a valid username, the dialog will override the global precommit.username hook by adding the following lines into the same `hgrc` file the username was stored: |
| Line 37: | Line 40: |
| === Config Command === | == Config Command == |
Config Extension
This extension is not distributed with Mercurial.
Author: Steve Borho
Repository: http://www.bitbucket.org/sborho/hgconfig/
Requires iniparse to be installed.
To use the dialogs, you must have PyQt4 or PyGtk installed. This extension is considered defunct, use TortoiseHg config dialogs instead. For command line access to configuration, consider HgcfgExtension.
Contents
1. Overview
This extension provides an hg config command which can be used to read or write values from your Mercurial configuration files. It also provides a small number of dialog windows for the most common configuration tasks.
2. Configuration
Configure your .hgrc to enable the extension by adding following lines:
[extensions] hgext.hgconfig =
Note that the hg-config repository comes with an hgconf.rc file which is intended to be copied into a site-wide hgrc.d/ directory. It enables the extension and configures the username hook (below).
3. Username Hook
This extension also provides a hook which can spawn the username dialog when a user tries to make a commit without a valid username. It is enabled by adding the following lines to the site-wide hgrc file.
[hooks] precommit.username = python:hgconf.uname.hook
After a user triggers the dialog and enters a valid username, the dialog will override the global precommit.username hook by adding the following lines into the same hgrc file the username was stored:
[hooks] precommit.username =
4. Config Command
When the extension is properly installed, you can easily get the online help.
% hg help config
hg config [<file-option>] [-gibBr] section.name [newvalue]
Apply a change or query a Mercurial configuration file.
By default changes are applied globally to a user's ~/.hgrc (or
equivalent) unless the --local flag is given, in which case the
changes are applied to this repository's $(hg root)/.hg/hgrc
file. The configuration file may also be explicitly specified
via the --file argument.
Examples:
hg config --get --local paths.default
hg config --get --bool diff.git
hg config --local paths.default ~/clone-parent
hg config ui.ssh "/path/to/ssh -C"
hg config --file /etc/mercurial/hgrc extensions.hgext.mq
To launch one of the provided dialogs:
hg config [--local] username
hg config paths # only operates on local repo
hg config webconf # only operates on local repo
The --get and --file options are by ignored dialog commands.
Get comamnds return 0 if successful, a boolean 0 or 1 if
--return-bool was specified, or 2 if an error occurred. The key
value is returned on stdout and all warnings are piped to stderr.
Note that 'hg config' is parsing a value from a particular file,
while Mercurial parses a series of files at startup in order
to read its configuration (man 5 hgrc). To see the actual value
that Mercurial will use, use the 'hg showconfig' command.
Set commands return 0 if successful, or 1 if a write failure
occurred
options:
-g --get get value for specified key
-i --int force retrieved value to be an integer
-b --bool force retrieved value to be a 0 or 1
-B --return-bool command returns 0 or 1 based on retrieved value
-l --local operate on configuration of local repository
-rm --remove remove specified key from file
--remove-section remove specified section from file
-f --file operate on specified config file
use "hg -v help config" to show global options