Diff for "RcpathExtension"

RcpathExtension

This extension is not distributed with Mercurial.

Author: G. Grothendieck

Download site: Download direct from this page - attachment:rcpath.py

Overview

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

use "hg -v help rcpath" to show global options

Configuration

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

[extensions]
hgext.rcpath =
#or, if rcpath.py is not in the hgext folder:
#rpcath = /path/to/rcpath.py

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:

http://www.selenic.com/mercurial/release

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()

Examples

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

The next example shows the use of the -a flag. The second output line did not appear in the previous example showing that in addition to the rcpath names that are being used that C:\Users\Jones\mercurial.ini could potentially be used as well.

C:\>hg rcpath -a
C:\Program Files\TortoiseHg\mercurial.ini
C:\Users\Jones\mercurial.ini
C:\Users\Jones\.hgrc

To explicitly get those rcpath names not in use:

hg rcpath > rcpath.txt
hg rcpath -a | diff - rcpath.txt

The last example should work on UNIX/Linux and on Windows with a suitable diff tool. Note that TortoiseHg on Windows already contains kdiff3 but kdiff3 does not support input pipes so in that case try this to get the unused rcpath names:

hg rpcath -a > rcpatha.txt
hg rcpath > rcpath.txt
kdiff3 rcpatha.txt rcpath.txt

CategoryExtension