NAME

       qct - Qt Commit Tool

SYNOPSIS

       qct [VCS]

DESCRIPTION

       The qct(1) command provides a common GUI commit dialog for many revision control systems
       across many platforms, including Linux/UNIX, MacOSX, and Microsoft Windows.

VERSION CONTROL SYSTEMS

       Mercurial
           [--hg|-h] Qct supports both the simple repository model and the Mercurial Queue patch
           maintenance model. When MQ patches are applied, qct will present a patch refresh user
           interface. Consult README.mercurial for more details.

       Bazaar
           [--bzr|-b] Bazaar support is complete, but could use some polishing. Qct can run as a
           bazaar plugin. Consult README.bazaar for more details.

       Perforce
           [--p4|-4] Perforce support is complete, if somewhat restrictive. On Windows, you must
           override P4DIFF with a command line diff tool. Consult README.perforce for more
           details.

       CVS
           [--cvs|-c] CVS support is feature complete, but not well tested. Consult README.cvs
           for more details.

       Monotone
           [--mtn|-m] Monotone support is feature complete, but not well tested. Consult
           README.monotone for more details.

       Subversion
           [--svn|-s] Subversion support is not very well tested at this time, so consider it
           alpha quality. Consult README.subversion for more details.

       Git
           [--cg] Git repositories are only supported via the Cogito front-end interface, which
           must be installed in order for Qct to work properly. Consult README.git for more
           details.

VCS INTEGRATION

       Qct can run as a plugin inside both Mercurial and Bazaar. Please consult the packaged
       INSTALL file and each plugin’s built-in help for more information.

SIGN OFF MESSAGES

       If you require a sign-off (or other) message to be appended to all of your commit
       messages, you can specify this message in the Qct preferences dialog. The sign-off message
       will not show up in the commit message window, but will be automatically appended to your
       message when passed to the VCS for commit.

CHANGE SELECTION

       Qct will allow you to select individual changes made to revisioned files, temporarily
       storing the remaining changes under a .qct/ directory until the commit has been completed.
       To enable this feature, you must configure a two-way merge application in the Qct
       preferences dialog. Kompare, meld, and kdiff3 are all known to work correctly in this
       mode. Any merge application which takes two file-names on the command line and allows them
       to be merged together can be used.

EXTERNAL EDITOR

       You can register an external editor with the Qct preferences dialog. Your editor will be
       presented as a context-menu option for all non-deleted commitable files in the file list.

EXTERNAL DIFF

       If your VCS supports external diff tools, you may register one of these with the Qct
       preferences dialog. Your diff tool will be offered in the context menu of all modified
       files in your file list. The diff tool will be provided with the list of selected files so
       it must be capable of retrieving the file diffs itself, typically by getting them from
       your revision control system.

FILES

       ~/.config/vcs/qct
           This file contains persistent data stored by Qct between invocations. It is not meant
           to be user modified.

BUGS

       Probably lots, please send them to be via e-mail when you find them. Patches (or mercurial
       bundles) are always welcome.

       Windows has a known limitation of 32Kbytes for it’s command line. Since Qct operates
       directly with the VCS command line tools, it is possible to run into this limit.

AUTHOR

       Written by Steve Borho <steve@borho.org[1]>

RESOURCES

       Web Page[2] Source code repository[3]

COPYING

       Copyright (C) 2006 Steve Borho Free use of this software is granted under the terms of the
       GNU General Public License (GPL)

AUTHOR

       Steve Borho <steve@borho.org>
           Author.

NOTES

        1. steve@borho.org
           mailto:steve@borho.org

        2. Web Page
           http://qct.sourceforge.net/

        3. Source code repository
           http://qct.sourceforge.net/hg/qct

                                            10/18/2011                                     QCT(1)