Merge branch 'es/doc-clean-outdated-tools' into maint

* es/doc-clean-outdated-tools:
  Documentation/git-tools: retire manually-maintained list
  Documentation/git-tools: drop references to defunct tools
  Documentation/git-tools: fix item text formatting
  Documentation/git-tools: improve discoverability of Git wiki
  Documentation/git: drop outdated Cogito reference
This commit is contained in:
Junio C Hamano 2015-08-19 14:41:31 -07:00
commit cacee08cd2
2 changed files with 9 additions and 117 deletions

View File

@ -1,118 +1,10 @@
A short Git tools survey
========================
Git Tools
=========
When Git was young, people looking for third-party Git-related tools came
to the Git project itself to find them, thus a list of such tools was
maintained here. These days, however, search engines fill that role much
more efficiently, so this manually-maintained list has been retired.
Introduction
------------
Apart from Git contrib/ area there are some others third-party tools
you may want to look.
This document presents a brief summary of each tool and the corresponding
link.
Alternative/Augmentative Porcelains
-----------------------------------
- *Cogito* (http://www.kernel.org/pub/software/scm/cogito/)
Cogito is a version control system layered on top of the Git tree history
storage system. It aims at seamless user interface and ease of use,
providing generally smoother user experience than the "raw" Core Git
itself and indeed many other version control systems.
Cogito is no longer maintained as most of its functionality
is now in core Git.
- *pg* (http://www.spearce.org/category/projects/scm/pg/)
pg is a shell script wrapper around Git to help the user manage a set of
patches to files. pg is somewhat like quilt or StGit, but it does have a
slightly different feature set.
- *StGit* (http://www.procode.org/stgit/)
Stacked Git provides a quilt-like patch management functionality in the
Git environment. You can easily manage your patches in the scope of Git
until they get merged upstream.
History Viewers
---------------
- *gitk* (shipped with git-core)
gitk is a simple Tk GUI for browsing history of Git repositories easily.
- *gitview* (contrib/)
gitview is a GTK based repository browser for Git
- *gitweb* (shipped with git-core)
Gitweb provides full-fledged web interface for Git repositories.
- *qgit* (http://digilander.libero.it/mcostalba/)
QGit is a git/StGit GUI viewer built on Qt/C++. QGit could be used
to browse history and directory tree, view annotated files, commit
changes cherry picking single files or applying patches.
Currently it is the fastest and most feature rich among the Git
viewers and commit tools.
- *tig* (http://jonas.nitro.dk/tig/)
tig by Jonas Fonseca is a simple Git repository browser
written using ncurses. Basically, it just acts as a front-end
for git-log and git-show/git-diff. Additionally, you can also
use it as a pager for Git commands.
Foreign SCM interface
---------------------
- *git-svn* (shipped with git-core)
git-svn is a simple conduit for changesets between a single Subversion
branch and Git.
- *quilt2git / git2quilt* (http://home-tj.org/wiki/index.php/Misc)
These utilities convert patch series in a quilt repository and commit
series in Git back and forth.
- *hg-to-git* (contrib/)
hg-to-git converts a Mercurial repository into a Git one, and
preserves the full branch history in the process. hg-to-git can
also be used in an incremental way to keep the Git repository
in sync with the master Mercurial repository.
Others
------
- *(h)gct* (http://www.cyd.liu.se/users/~freku045/gct/)
Commit Tool or (h)gct is a GUI enabled commit tool for Git and
Mercurial (hg). It allows the user to view diffs, select which files
to committed (or ignored / reverted) write commit messages and
perform the commit itself.
- *git.el* (contrib/)
This is an Emacs interface for Git. The user interface is modelled on
pcl-cvs. It has been developed on Emacs 21 and will probably need some
tweaking to work on XEmacs.
http://git.or.cz/gitwiki/InterfacesFrontendsAndTools has more
comprehensive list.
See also the `contrib/` area, and the Git wiki:
http://git.or.cz/gitwiki/InterfacesFrontendsAndTools

View File

@ -781,7 +781,7 @@ The Git Repository
~~~~~~~~~~~~~~~~~~
These environment variables apply to 'all' core Git commands. Nb: it
is worth noting that they may be used/overridden by SCMS sitting above
Git so take care if using Cogito etc.
Git so take care if using a foreign front-end.
'GIT_INDEX_FILE'::
This environment allows the specification of an alternate