QCT(1)																	    QCT(1)

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

								    08/22/2011								    QCT(1)