[PATCH] Add a Documentation/git-tools.txt

A brief survey of useful git tools, including third-party
and external projects.

Signed-off-by: Marco Costalba <redacted>
---

Please consider this more of a RFC  then a finished patch.

Where possible, for each tool, the author's description is used as a summary.
I found http://git.or.cz/ a good source.

Tools are listed alphabetically in for each section.

Feel free to add/modify comments or tool's summaries. As stated this is still a
work in progress.


  Documentation/git-tools.txt |   90 +++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 90 insertions(+), 0 deletions(-)
  create mode 100644 Documentation/git-tools.txt

355a382ecca292363af2a0be4769c2b2fb2ea9e7

diff --git a/Documentation/git-tools.txt b/Documentation/git-tools.txt
new file mode 100644
index 0000000..7e563db
--- /dev/null
+++ b/Documentation/git-tools.txt

@@ -0,0 +1,90 @@
+A short git tools survey
+========================
+
+
+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/Argumentative 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.
+
+
+        - *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://homepage.ntlworld.com/cmarinas/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* (ftp://ftp.kernel.org/pub/software/scm/gitweb/)
+
+            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.
+
+
+
+Foreign SCM interface
+---------------------
+
+        - *git-svn* (contrib/)
+
+            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.
+
+
+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.
+
+
--
1.2.0.g62a4

On Sunday 19 February 2006 10:00, Marco Costalba wrote:

+
+Alternative/Argumentative Porcelains
+------------------------------------

Aren't these "Augmentative Procelains" rather than ones that argue a lot.

-- 
Alan Chandler
http://www.chandlerfamily.org.uk
Open Source. It's the difference between trust and antitrust.

Alan Chandler ha scritto:

On Sunday 19 February 2006 10:00, Marco Costalba wrote:

quoted

+
+Alternative/Argumentative Porcelains
+------------------------------------

Aren't these "Augmentative Procelains" rather than ones that argue a lot.

Yes, you are arguing correctly!

Marco Costalba [off-list ref] wrote Sun, Feb 19, 2006:

+	- *gitview*  (contrib/)
+
+            gitview is a GTK based repository browser for git
+
+
+	- *gitweb* (ftp://ftp.kernel.org/pub/software/scm/gitweb/)
+
+            GITweb provides full-fledged web interface for GIT repositories.

You can make it more asciidoc-friendly if you convert the list to use
the format:

*gitview* (contrib)::

	gitview is a GTK based repository browser for git

ftp://ftp.kernel.org/pub/software/scm/gitweb/[*gitweb*]::

	GITweb provides full-fledged web interface for GIT repositories.

-- 
Jonas Fonseca

On 2/20/06, Jonas Fonseca [off-list ref] wrote:

Marco Costalba [off-list ref] wrote Sun, Feb 19, 2006:

quoted

+     - *gitview*  (contrib/)
+
+            gitview is a GTK based repository browser for git
+
+
+     - *gitweb* (ftp://ftp.kernel.org/pub/software/scm/gitweb/)
+
+            GITweb provides full-fledged web interface for GIT repositories.

You can make it more asciidoc-friendly if you convert the list to use
the format:

*gitview* (contrib)::

        gitview is a GTK based repository browser for git

ftp://ftp.kernel.org/pub/software/scm/gitweb/[*gitweb*]::

        GITweb provides full-fledged web interface for GIT repositories.

--
Jonas Fonseca

Thanks, I will change the format.

I am waiting to collect some more comments so to change git-tools.txt only once.

Marco