improved Configuration explanation
|Deletions are marked like this.||Additions are marked like this.|
|Line 28:||Line 28:|
|Configure your `.hgrc` to enable the extension by adding following lines:||Configure your .hgrc to enable the extension by adding following lines:|
|Line 32:||Line 32:|
#or, if rcpath.py is not in the hgext folder:
#rpcath = /path/to/rcpath.py
|Line 36:||Line 35:|
|or place rcpath.py in your 'hgext' directory and add the following lines:
This extension is not distributed with Mercurial.
Author: G. Grothendieck
Download site: Download direct from this page - attachment:rcpath.py
This extension displays Mercurial configuration file paths and names.
hg rcpath show path/file names to startup files options: -a --all all path/names that could be used -d --duplicates retain duplicates -n --notused path/names not in use use "hg -v help rcpath" to show global options
Configure your .hgrc to enable the extension by adding following lines:
or place rcpath.py in your 'hgext' directory and add the following lines:
To perform the above configuration you will need to know at least one .hgrc or mercurial.ini pathname. The information for this can be found at [http://www.selenic.com/hg/?f=-1;style=raw;file=doc/hgrc.5.txt hgrc.5.txt] and includes locations such as ~/.hgrc and usually /etc/mercurial/hgrc on UNIX/Linux and %USERPROFILE%\.hgrc (e.g. C:\Users\JoeDoe\.hgrc) on Windows.
If you can't figure it out from that then the following shows how to get a list of the pathnames without previously installing rcpath. Make sure that you have a working tar (Windows users can download and install Rtools from http://www.murdoch-sutherland.com/Rtools/ which contains tar.exe that can be placed on the PATH or in the current directory or get tar.exe from one of any of a number of other free sources on the net) and Python:
1. download mercurial source from:
2. run the following console/shell commands except the last two lines are entered into the python command line. Also note that the portion typed by the user is the portion after the last > on each line. The example here uses Mercurial 1.0.2 but replace that with whatever is the latest version:
C:\tmp> tar xvfz mercurial-1.0.2.tar.gz C:\tmp> cd mercurial-1.0.2/mercurial C:\tmp\mercurial-1.0.2\mercurial> python >>> from util import * >>> rcpath()
Here is an example of the use of the rcpath extension showing the two rc files that are currently being used. The first line is the input and the subsequent lines are the output that is returned.
C:\>hg rcpath C:\Program Files\TortoiseHg\mercurial.ini C:\Users\Jones\.hgrc
In the following example we use the -n flag to show those rcpath names that are not in use:
C:\>hg rcpath -n C:\Users\Jones\mercurial.ini
In the next example we use the -a flag to show all rcpath names including both those in use and those not in use:
C:\>hg rcpath -a C:\Program Files\TortoiseHg\mercurial.ini C:\Users\Jones\mercurial.ini C:\Users\Jones\.hgrc