Qct extension

This extension is not being distributed along with Mercurial.

Author: Steve Borho

Download site: [http://hg.borho.org/qct public development repository].

Overview

The qct.py extension provides improved access to the Qct graphical commit tool. Qct is meant to be portable across platforms and version control tools, and requires Qt version 4.0 or later, which is not being distributed with Mercurial.

The qct.py extension adds a qct command which supports only a single command line parameter.

Configuration

Follow Qct's INSTALL instructions to get the base application installed on your system.

qct.py is located in the plugins directory.

To load an extension, you add it to your .hgrc file (you have to use your global $HOME/.hgrc file, not one in a repository). You can specify an absolute path:

[extensions]
qct=/usr/local/lib/qct.py

Mercurial can also scan the default python library path for a file named 'qct.py' if you set qct empty:

[extensions]
qct=

If you are running on Windows, and qct.py is unable to find your Qct executable, you can specify the path to Qct in your .hgrc file:

[qct]
path=/location/of/Qct.exe

Now hg help will show the new commands provided by the qct extension:

$ hg help qct
hg commit-tool [.]

Qt-based GUI Commit Tool

       If '.' is given as an argument the tool will operate out of the
       current directory, else it will operate repository-wide.

       This command will open a window from which you can browse all of
       the commitable changes you have made to your working directory.
       You can then enter a log message and commit your changes to the
       repository.  You can remove files from the commit list by
       de-selecting them in the file list.

       Keyboard Shortcuts:

       CTRL-O  - Commit selected files
       CTRL-R  - Refresh file list
       CTRL-N  - View diffs of next file in list
       CTRL-[] - Page up/down through file diffs
       CTRL-U  - Unselect all files
       ESC     - Abort and exit

aliases: qct

$ hg qct

Selected font size will be saved in ~/.gitk and reused in the next session.


CategoryExtension