threads / patch / 3391

patchAdd a Documentation/git-tools.txt

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

## tl;dr

13 messages between Feb 19, 2006 and Mar 4, 2006. Diffs are folded; open one to read it.

replies: 12people: 6as markdown or json

Marco Costalba· Feb 19, 2006, 10:00 UTC · lore

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

Signed-off-by: Marco Costalba <mcostalba@gmail.com>
---
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
Show changes to Documentation/git-tools.txt +90 −1
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
Junio C Hamano· Feb 19, 2006, 10:59 UTC · re: Marco Costalba · lore

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

"Marco Costalba" <mcostalba@gmail.com> writes:
Show 10 quoted lines
> A brief survey of useful git tools, including third-party
> and external projects.
>
> Signed-off-by: Marco Costalba <mcostalba@gmail.com>
> ---
>
> 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.
Thanks for starting this.

Briefly mentioning tool's strength and weakness without being too subjective would be very helpful to potential users. We would encourage competition without making other tools sound inferiour on subjective terms. So "this is similar to foobar tool, but runs much faster, but has these limitations" would be a good style, but "this draws much nicer picture than barboz" without substantiating why it is nicer may be suboptimal. Also I am a bit afraid that the summary can become stale unless maintained actively. Hopefully the respective authors of tools can keep us updated.

I am of two minds about mentioning things available from the git repository, but I think it makes the survey more complete and more useful in general to include them in the list. The private draft I sent out to you earlier forgot to include the foreign SCM interfaces.

Marco Costalba· Feb 19, 2006, 12:04 UTC · re: Junio C Hamano · lore

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

On 2/19/06, Junio C Hamano <junkio@cox.net> wrote:
Show 10 quoted lines
>
> Thanks for starting this.
>
> Briefly mentioning tool's strength and weakness without being
> too subjective would be very helpful to potential users.  We
> would encourage competition without making other tools sound
> inferiour on subjective terms.  So "this is similar to foobar
> tool, but runs much faster, but has these limitations" would be
> a good style, but "this draws much nicer picture than barboz"
> without substantiating why it is nicer may be suboptimal.

Ok, I resend the patch with 'encouraged competition' comments on, guess what, qgit. It is a little bit biased but provable. I speak only for tools I know well. I would like each tool author writes it's own advertising ;-)

Also added the freshly new contrib/ emacs interface, called pcl-cvs, as in revision log message.

> I am a bit afraid that the summary can become stale unless
> maintained actively.
This is unavoidable but also a useful 'watchdog' to test active maintenance.
> I am of two minds about mentioning things available from the git
> repository, but I think it makes the survey more complete and
> more useful in general to include them in the list.
>

I agree, we don't have hundreds of tools around, so list all in just one place perhaps is not the cleanest thing, but it is more user friendly.

--------------------------  cut ----------------------------------
From: Marco Costalba <mcostalba@gmail.com>
Date: Sun Feb 19 12:52:07 2006 +0100
Subject: [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 <mcostalba@gmail.com>
---
  Documentation/git-tools.txt |   97 +++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 97 insertions(+), 0 deletions(-)
  create mode 100644 Documentation/git-tools.txt
ce159730f858f50046186301f2d8668c66526627
Show changes to Documentation/git-tools.txt +97 −1
diff --git a/Documentation/git-tools.txt b/Documentation/git-tools.txt
new file mode 100644
index 0000000..93a8d8b
--- /dev/null
+++ b/Documentation/git-tools.txt
@@ -0,0 +1,97 @@
+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.
+            Currently it is the fastest and most feature rich among
the git viewers
+            and commit tools.
+
+
+
+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.
+
+        - *pcl-cvs* (contrib/)
+
+            This is an Emacs interface for git. The user interface is
modeled on
+            pcl-cvs. It has been developed on Emacs 21 and will
probably need some
+            tweaking to work on XEmacs.
+
--
1.2.0.g709a
Alan Chandler· Feb 19, 2006, 12:25 UTC · re: Marco Costalba · lore

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

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.
Marco Costalba· Feb 19, 2006, 12:39 UTC · re: Alan Chandler · lore

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

Alan Chandler ha scritto:
Show 9 quoted lines
> 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.
> 
Yes, you are arguing correctly!
Jonas Fonseca· Feb 20, 2006, 02:01 UTC · re: Marco Costalba · lore

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

Marco Costalba <mcostalba@gmail.com> wrote Sun, Feb 19, 2006:
Show 8 quoted lines
> +	- *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
Marco Costalba· Feb 20, 2006, 06:21 UTC · re: Jonas Fonseca · lore

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

On 2/20/06, Jonas Fonseca <fonseca@diku.dk> wrote:
Show 24 quoted lines
> Marco Costalba <mcostalba@gmail.com> 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
>
Thanks, I will change the format.
I am waiting to collect some more comments so to change git-tools.txt only once.
Marco
Catalin Marinas· Feb 20, 2006, 10:31 UTC · re: Marco Costalba · lore

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

"Marco Costalba" <mcostalba@gmail.com> wrote:
> +        - *StGit* (http://homepage.ntlworld.com/cmarinas/stgit/)
This line should be:
+        - *StGIT* (http://www.procode.org/stgit/)
The URL you put is just the download area which may change.
Thanks.
-- 
Catalin
Marco Costalba· Feb 26, 2006, 08:22 UTC · re: Catalin Marinas · lore

Re: [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 <mcostalba@gmail.com>
---

Suggestions/corrections from the list has been collected during the past week, so I resend the updated patch.

Please consider for apply.

One note. The suggestion of Jonas ( -*gitview* -> *gitview* :: ) has not been applied because the output had no indent on project name. I played a little with asciidoc to get an indent but without success, so I revert to original indented format.

  Documentation/git-tools.txt |   97 +++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 97 insertions(+), 0 deletions(-)
  create mode 100644 Documentation/git-tools.txt
8f41794257a6efe46f44e056710dfadcfbf362d7
Show changes to Documentation/git-tools.txt +97 −1
diff --git a/Documentation/git-tools.txt b/Documentation/git-tools.txt
new file mode 100644
index 0000000..7854972
--- /dev/null
+++ b/Documentation/git-tools.txt
@@ -0,0 +1,97 @@
+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/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.
+
+
+        - *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* (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.
+            Currently it is the fastest and most feature rich among
the git viewers
+            and commit tools.
+
+
+
+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.
+
+        - *pcl-cvs* (contrib/)
+
+            This is an Emacs interface for git. The user interface is
modeled on
+            pcl-cvs. It has been developed on Emacs 21 and will
probably need some
+            tweaking to work on XEmacs.
+
--
1.2.2.g8fcf1
Junio C Hamano· Feb 26, 2006, 22:51 UTC · re: Marco Costalba · lore

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

"Marco Costalba" <mcostalba@gmail.com> writes:
Show 11 quoted lines
> A brief survey of useful git tools, including third-party
> and external projects.
>
> Signed-off-by: Marco Costalba <mcostalba@gmail.com>
> ---
>
> Suggestions/corrections from the list has been collected during the
> past week, so I resend
> the updated patch.
>
> Please consider for apply.
Thanks.  I've considered it, but it is seriously linewrapped.
Show 5 quoted lines
> +        - *pcl-cvs* (contrib/)
> +
> +            This is an Emacs interface for git. The user interface is
> modeled on
> +            pcl-cvs.

Also is the emacs one really pcl-cvs? I thought it was modeled after pcl-cvs, but this is a different implementation to deal with git. If Alexandre does not have a name for it, I'd say we'll list it as "git.el".

Marco Costalba· Feb 27, 2006, 06:44 UTC · re: Junio C Hamano · lore

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

On 2/26/06, Junio C Hamano <junkio@cox.net> wrote:
Show 5 quoted lines
> >
> > Please consider for apply.
>
> Thanks.  I've considered it, but it is seriously linewrapped.
>
Sorry for this. It is ok 80 columns max?
Show 11 quoted lines
> > +        - *pcl-cvs* (contrib/)
> > +
> > +            This is an Emacs interface for git. The user interface is
> > modeled on
> > +            pcl-cvs.
>
> Also is the emacs one really pcl-cvs?  I thought it was modeled
> after pcl-cvs, but this is a different implementation to deal
> with git.  If Alexandre does not have a name for it, I'd say
> we'll list it as "git.el".
>
Ok, waiting for Alexandre's answer.

This week I foreseen to be quite busy, so perhaps the patch will be delayed a little bit.

Marco
Alexandre Julliard· Feb 27, 2006, 08:39 UTC · re: Junio C Hamano · lore

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

Junio C Hamano <junkio@cox.net> writes:
> Also is the emacs one really pcl-cvs?  I thought it was modeled
> after pcl-cvs, but this is a different implementation to deal
> with git.  If Alexandre does not have a name for it, I'd say
> we'll list it as "git.el".
It doesn't really have a specific name, so yes, "git.el" is fine.
-- 
Alexandre Julliard
julliard@winehq.org
Marco Costalba· Mar 4, 2006, 06:42 UTC · re: Alexandre Julliard · lore

Re: [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 <mcostalba@gmail.com>
---
 Documentation/git-tools.txt |   97 +++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 97 insertions(+), 0 deletions(-)
 create mode 100644 Documentation/git-tools.txt
5e8c2ec9d08dce7f333b0963d7911c3096ab6588
Show changes to Documentation/git-tools.txt +97 −1
diff --git a/Documentation/git-tools.txt b/Documentation/git-tools.txt
new file mode 100644
index 0000000..00e57a6
--- /dev/null
+++ b/Documentation/git-tools.txt
@@ -0,0 +1,97 @@
+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/Augmentative Procelains
+-----------------------------------
+
+   - *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://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* (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.
+   Currently it is the fastest and most feature rich among the git
+   viewers and commit tools.
+
+
+
+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.
+
+   - *git.el* (contrib/)
+
+   This is an Emacs interface for git. The user interface is modeled on
+   pcl-cvs. It has been developed on Emacs 21 and will probably need some
+   tweaking to work on XEmacs.
--
1.2.2.gce4c

← back to recent threads