Documentation/git-tools: improve discoverability of Git wiki
[git/debian.git] / Documentation / git-tools.txt
blob129b8c0c498c9e264e977fca25e1518808ea4ce0
1 A short Git tools survey
2 ========================
5 Introduction
6 ------------
8 Apart from Git contrib/ area there are some others third-party tools
9 you may want to look at.
10 This document presents a brief summary of each tool and the corresponding
11 link.
12 For a more comprehensive list, see:
13 http://git.or.cz/gitwiki/InterfacesFrontendsAndTools
16 Alternative/Augmentative Porcelains
17 -----------------------------------
19    - *Cogito* (http://www.kernel.org/pub/software/scm/cogito/)
21    Cogito is a version control system layered on top of the Git tree history
22    storage system. It aims at seamless user interface and ease of use,
23    providing generally smoother user experience than the "raw" Core Git
24    itself and indeed many other version control systems.
26    Cogito is no longer maintained as most of its functionality
27    is now in core Git.
30    - *pg* (http://www.spearce.org/category/projects/scm/pg/)
32    pg is a shell script wrapper around Git to help the user manage a set of
33    patches to files. pg is somewhat like quilt or StGit, but it does have a
34    slightly different feature set.
37    - *StGit* (http://www.procode.org/stgit/)
39    Stacked Git provides a quilt-like patch management functionality in the
40    Git environment. You can easily manage your patches in the scope of Git
41    until they get merged upstream.
44 History Viewers
45 ---------------
47    - *gitk* (shipped with git-core)
49    gitk is a simple Tk GUI for browsing history of Git repositories easily.
52    - *gitview*  (contrib/)
54    gitview is a GTK based repository browser for Git
57    - *gitweb* (shipped with git-core)
59    Gitweb provides full-fledged web interface for Git repositories.
62    - *qgit* (http://digilander.libero.it/mcostalba/)
64    QGit is a git/StGit GUI viewer built on Qt/C++. QGit could be used
65    to browse history and directory tree, view annotated files, commit
66    changes cherry picking single files or applying patches.
67    Currently it is the fastest and most feature rich among the Git
68    viewers and commit tools.
70    - *tig* (http://jonas.nitro.dk/tig/)
72    tig by Jonas Fonseca is a simple Git repository browser
73    written using ncurses. Basically, it just acts as a front-end
74    for git-log and git-show/git-diff. Additionally, you can also
75    use it as a pager for Git commands.
78 Foreign SCM interface
79 ---------------------
81    - *git-svn* (shipped with git-core)
83    git-svn is a simple conduit for changesets between a single Subversion
84    branch and Git.
87    - *quilt2git / git2quilt* (http://home-tj.org/wiki/index.php/Misc)
89    These utilities convert patch series in a quilt repository and commit
90    series in Git back and forth.
93    - *hg-to-git* (contrib/)
95    hg-to-git converts a Mercurial repository into a Git one, and
96    preserves the full branch history in the process. hg-to-git can
97    also be used in an incremental way to keep the Git repository
98    in sync with the master Mercurial repository.
101 Others
102 ------
104    - *(h)gct* (http://www.cyd.liu.se/users/~freku045/gct/)
106    Commit Tool or (h)gct is a GUI enabled commit tool for Git and
107    Mercurial (hg). It allows the user to view diffs, select which files
108    to committed (or ignored / reverted) write commit messages and
109    perform the commit itself.
111    - *git.el* (contrib/)
113    This is an Emacs interface for Git. The user interface is modelled on
114    pcl-cvs. It has been developed on Emacs 21 and will probably need some
115    tweaking to work on XEmacs.