{"thread":{"id":"39960","subject":"[PATCH v2 1/6] Documentation/config: mention \"now\" and \"never\" for 'expire' settings","startedAt":"2015-07-28T20:06:09Z","lastAt":"2015-07-28T20:06:15Z","messageCount":7,"participants":["Eric Sunshine"],"isPatch":true,"patchVersion":2,"patchTotal":6},"messages":[{"id":"266986","messageId":"1438113975-4915-1-git-send-email-sunshine@sunshineco.com","threadId":"39960","inReplyTo":null,"subject":"[PATCH v2 0/6] minor documentation improvements","fromName":"Eric Sunshine","fromEmail":"sunshine@sunshineco.com","sentAt":"2015-07-28T20:06:09Z","receivedAt":"2015-07-28T20:06:09Z","isPatch":true,"sender":{"key":"sunshine@sunshineco.com","avatar":"https://avatars.githubusercontent.com/u/163641?v=4"},"body":"This is a re-roll of [1] which makes minor improvements to documentation\nbased upon observations of Michael Haggerty, Junio, and myself. This\nversion addresses review comments by Michael[2] and includes follow-on\npatch 7/6 which arose[3] from my observation that it may be time to\nretire the manually-maintained list of 3rd party tools altogether. This\nversion also drops v1 patch 1/6 since that patch[4] has already migrated\nto 'next'[5].\n\nThis is built atop [5] in 'next'. A v1 to v2 interdiff is included\nbelow.\n\n[1]: http://thread.gmane.org/gmane.comp.version-control.git/274537\n[2]: http://article.gmane.org/gmane.comp.version-control.git/274647\n[3]: http://article.gmane.org/gmane.comp.version-control.git/274602\n[4]: http://article.gmane.org/gmane.comp.version-control.git/274541\n[5]: 5f5f553 (Documentation/git-worktree: fix broken 'linkgit' invocation, 2015-07-24)\n\nEric Sunshine (6):\n  Documentation/config: mention \"now\" and \"never\" for 'expire' settings\n  Documentation/git: drop outdated Cogito reference\n  Documentation/git-tools: improve discoverability of Git wiki\n  Documentation/git-tools: fix item text formatting\n  Documentation/git-tools: drop references to defunct tools\n  Documentation/git-tools: retire manually-maintained list\n\n Documentation/config.txt    |  16 ++++--\n Documentation/git-tools.txt | 124 +++-----------------------------------------\n Documentation/git.txt       |   2 +-\n 3 files changed, 20 insertions(+), 122 deletions(-)\n\n-- \n2.5.0.rc3.490.g8c70279\n\n\n--- 8< ---\ndiff --git a/Documentation/config.txt b/Documentation/config.txt\nindex ba37a36..e09ee02 100644\n--- a/Documentation/config.txt\n+++ b/Documentation/config.txt\n@@ -1227,21 +1227,23 @@ gc.pruneexpire::\n \tWhen 'git gc' is run, it will call 'prune --expire 2.weeks.ago'.\n \tOverride the grace period with this config variable.  The value\n \t\"now\" may be used to disable this grace period and always prune\n-\tunreachable objects immediately; or \"never\" to suppress pruning.\n+\tunreachable objects immediately, or \"never\" may be used to\n+\tsuppress pruning.\n \n gc.worktreePruneExpire::\n \tWhen 'git gc' is run, it calls\n \t'git worktree prune --expire 3.months.ago'.\n \tThis config variable can be used to set a different grace\n \tperiod. The value \"now\" may be used to disable the grace\n-\tperiod and prune $GIT_DIR/worktrees immediately; or \"never\" to\n-\tsuppress pruning.\n+\tperiod and prune $GIT_DIR/worktrees immediately, or \"never\"\n+\tmay be used to suppress pruning.\n \n gc.reflogexpire::\n gc.<pattern>.reflogexpire::\n \t'git reflog expire' removes reflog entries older than\n-\tthis time; defaults to 90 days. The value \"all\" expires all\n-\tentries; and \"false\" disables expiration. With \"<pattern>\" (e.g.\n+\tthis time; defaults to 90 days. The value \"now\" expires all\n+\tentries immediately, and \"never\" suppresses expiration\n+\taltogether. With \"<pattern>\" (e.g.\n \t\"refs/stash\") in the middle the setting applies only to\n \tthe refs that match the <pattern>.\n \n@@ -1249,8 +1251,9 @@ gc.reflogexpireunreachable::\n gc.<ref>.reflogexpireunreachable::\n \t'git reflog expire' removes reflog entries older than\n \tthis time and are not reachable from the current tip;\n-\tdefaults to 30 days. The value \"all\" expires all entries; and\n-\t\"false\" disables expiration. With \"<pattern>\" (e.g. \"refs/stash\")\n+\tdefaults to 30 days. The value \"now\" expires all entries\n+\timmediately, and \"never\" suppresses expiration altogether.\n+\tWith \"<pattern>\" (e.g. \"refs/stash\")\n \tin the middle, the setting applies only to the refs that\n \tmatch the <pattern>.\n \ndiff --git a/Documentation/git-tools.txt b/Documentation/git-tools.txt\nindex 48a3595..2f4ff50 100644\n--- a/Documentation/git-tools.txt\n+++ b/Documentation/git-tools.txt\n@@ -1,84 +1,10 @@\n-A short Git tools survey\n-========================\n+Git Tools\n+=========\n \n+When Git was young, people looking for third-party Git-related tools came\n+to the Git project itself to find them, thus a list of such tools was\n+maintained here. These days, however, search engines fill that role much\n+more efficiently, so this manually-maintained list has been retired.\n \n-Introduction\n-------------\n-\n-Apart from Git contrib/ area there are some others third-party tools\n-you may want to look at.\n-This document presents a brief summary of each tool and the corresponding\n-link.\n-For a more comprehensive list, see:\n+See also the `contrib/` area, and the Git wiki:\n http://git.or.cz/gitwiki/InterfacesFrontendsAndTools\n-\n-\n-Alternative/Augmentative Porcelains\n------------------------------------\n-\n-- *StGit* (http://www.procode.org/stgit/)\n-+\n-Stacked Git provides a quilt-like patch management functionality in the\n-Git environment. You can easily manage your patches in the scope of Git\n-until they get merged upstream.\n-\n-\n-History Viewers\n----------------\n-\n-- *gitk* (shipped with git-core)\n-+\n-gitk is a simple Tk GUI for browsing history of Git repositories easily.\n-\n-\n-- *gitview*  (contrib/)\n-+\n-gitview is a GTK based repository browser for Git\n-\n-\n-- *gitweb* (shipped with git-core)\n-+\n-Gitweb provides full-fledged web interface for Git repositories.\n-\n-\n-- *qgit* (http://digilander.libero.it/mcostalba/)\n-+\n-QGit is a git/StGit GUI viewer built on Qt/C++. QGit could be used\n-to browse history and directory tree, view annotated files, commit\n-changes cherry picking single files or applying patches.\n-Currently it is the fastest and most feature rich among the Git\n-viewers and commit tools.\n-\n-- *tig* (http://jonas.nitro.dk/tig/)\n-+\n-tig by Jonas Fonseca is a simple Git repository browser\n-written using ncurses. Basically, it just acts as a front-end\n-for git-log and git-show/git-diff. Additionally, you can also\n-use it as a pager for Git commands.\n-\n-\n-Foreign SCM interface\n----------------------\n-\n-- *git-svn* (shipped with git-core)\n-+\n-git-svn is a simple conduit for changesets between a single Subversion\n-branch and Git.\n-\n-\n-- *hg-to-git* (contrib/)\n-+\n-hg-to-git converts a Mercurial repository into a Git one, and\n-preserves the full branch history in the process. hg-to-git can\n-also be used in an incremental way to keep the Git repository\n-in sync with the master Mercurial repository.\n-\n-\n-Others\n-------\n-\n-- *git.el* (contrib/)\n-+\n-This is an Emacs interface for Git. The user interface is modelled on\n-pcl-cvs. It has been developed on Emacs 21 and will probably need some\n-tweaking to work on XEmacs.\n--- 8< ---\n"},{"id":"266980","messageId":"1438113975-4915-2-git-send-email-sunshine@sunshineco.com","threadId":"39960","inReplyTo":"1438113975-4915-1-git-send-email-sunshine@sunshineco.com","subject":"[PATCH v2 1/6] Documentation/config: mention \"now\" and \"never\" for 'expire' settings","fromName":"Eric Sunshine","fromEmail":"sunshine@sunshineco.com","sentAt":"2015-07-28T20:06:10Z","receivedAt":"2015-07-28T20:06:10Z","isPatch":true,"sender":{"key":"sunshine@sunshineco.com","avatar":"https://avatars.githubusercontent.com/u/163641?v=4"},"body":"In addition to approxidate-style values (\"2.months.ago\", \"yesterday\"),\nconsumers of 'gc.*expire*' configuration variables also accept and\nrespect 'now' (\"do it immediately\") and 'never' (\"suppress entirely\").\n\nSuggested-by: Michael Haggerty <mhagger@alum.mit.edu>\nSigned-off-by: Eric Sunshine <sunshine@sunshineco.com>\n---\n\nChanges since v1:\n* grammatical corrections\n* use \"now\"/\"never\" consistently; avoid \"all\"/\"false\"\n\n Documentation/config.txt | 16 +++++++++++-----\n 1 file changed, 11 insertions(+), 5 deletions(-)\n\ndiff --git a/Documentation/config.txt b/Documentation/config.txt\nindex 583d24f..e09ee02 100644\n--- a/Documentation/config.txt\n+++ b/Documentation/config.txt\n@@ -1226,20 +1226,24 @@ gc.packrefs::\n gc.pruneexpire::\n \tWhen 'git gc' is run, it will call 'prune --expire 2.weeks.ago'.\n \tOverride the grace period with this config variable.  The value\n-\t\"now\" may be used to disable this  grace period and always prune\n-\tunreachable objects immediately.\n+\t\"now\" may be used to disable this grace period and always prune\n+\tunreachable objects immediately, or \"never\" may be used to\n+\tsuppress pruning.\n \n gc.worktreePruneExpire::\n \tWhen 'git gc' is run, it calls\n \t'git worktree prune --expire 3.months.ago'.\n \tThis config variable can be used to set a different grace\n \tperiod. The value \"now\" may be used to disable the grace\n-\tperiod and prune $GIT_DIR/worktrees immediately.\n+\tperiod and prune $GIT_DIR/worktrees immediately, or \"never\"\n+\tmay be used to suppress pruning.\n \n gc.reflogexpire::\n gc.<pattern>.reflogexpire::\n \t'git reflog expire' removes reflog entries older than\n-\tthis time; defaults to 90 days.  With \"<pattern>\" (e.g.\n+\tthis time; defaults to 90 days. The value \"now\" expires all\n+\tentries immediately, and \"never\" suppresses expiration\n+\taltogether. With \"<pattern>\" (e.g.\n \t\"refs/stash\") in the middle the setting applies only to\n \tthe refs that match the <pattern>.\n \n@@ -1247,7 +1251,9 @@ gc.reflogexpireunreachable::\n gc.<ref>.reflogexpireunreachable::\n \t'git reflog expire' removes reflog entries older than\n \tthis time and are not reachable from the current tip;\n-\tdefaults to 30 days.  With \"<pattern>\" (e.g. \"refs/stash\")\n+\tdefaults to 30 days. The value \"now\" expires all entries\n+\timmediately, and \"never\" suppresses expiration altogether.\n+\tWith \"<pattern>\" (e.g. \"refs/stash\")\n \tin the middle, the setting applies only to the refs that\n \tmatch the <pattern>.\n \n-- \n2.5.0.rc3.490.g8c70279\n"},{"id":"266981","messageId":"1438113975-4915-3-git-send-email-sunshine@sunshineco.com","threadId":"39960","inReplyTo":"1438113975-4915-1-git-send-email-sunshine@sunshineco.com","subject":"[PATCH v2 2/6] Documentation/git: drop outdated Cogito reference","fromName":"Eric Sunshine","fromEmail":"sunshine@sunshineco.com","sentAt":"2015-07-28T20:06:11Z","receivedAt":"2015-07-28T20:06:11Z","isPatch":true,"sender":{"key":"sunshine@sunshineco.com","avatar":"https://avatars.githubusercontent.com/u/163641?v=4"},"body":"Cogito hasn't been maintained since late 2006, so drop the reference\nto it. The warning that SCMS front-ends might override listed\nenvironment variables, however, may still be valuable, so keep it but\ngeneralize the wording.\n\nSuggested-by: Junio C Hamano <gitster@pobox.com>\nSigned-off-by: Eric Sunshine <sunshine@sunshineco.com>\n---\n\nNo changes since v1.\n\n Documentation/git.txt | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/Documentation/git.txt b/Documentation/git.txt\nindex ef76f95..21bc0a5 100644\n--- a/Documentation/git.txt\n+++ b/Documentation/git.txt\n@@ -744,7 +744,7 @@ The Git Repository\n ~~~~~~~~~~~~~~~~~~\n These environment variables apply to 'all' core Git commands. Nb: it\n is worth noting that they may be used/overridden by SCMS sitting above\n-Git so take care if using Cogito etc.\n+Git so take care if using a foreign front-end.\n \n 'GIT_INDEX_FILE'::\n \tThis environment allows the specification of an alternate\n-- \n2.5.0.rc3.490.g8c70279\n"},{"id":"266982","messageId":"1438113975-4915-4-git-send-email-sunshine@sunshineco.com","threadId":"39960","inReplyTo":"1438113975-4915-1-git-send-email-sunshine@sunshineco.com","subject":"[PATCH v2 3/6] Documentation/git-tools: improve discoverability of Git wiki","fromName":"Eric Sunshine","fromEmail":"sunshine@sunshineco.com","sentAt":"2015-07-28T20:06:12Z","receivedAt":"2015-07-28T20:06:12Z","isPatch":true,"sender":{"key":"sunshine@sunshineco.com","avatar":"https://avatars.githubusercontent.com/u/163641?v=4"},"body":"These days, the best way to find Git-related tools is via a search\nengine. The Git wiki may be a distant second, and git-tools.txt falls in\nlast place. Therefore, promote the Git wiki reference to the top of\ngit-tools.txt so the reader will encounter it first, rather than hiding\nit away at the very bottom.\n\nSigned-off-by: Eric Sunshine <sunshine@sunshineco.com>\n---\n\nChanges since v1: reword commit message slightly\n\n Documentation/git-tools.txt | 9 +++------\n 1 file changed, 3 insertions(+), 6 deletions(-)\n\ndiff --git a/Documentation/git-tools.txt b/Documentation/git-tools.txt\nindex 78a0d95..129b8c0 100644\n--- a/Documentation/git-tools.txt\n+++ b/Documentation/git-tools.txt\n@@ -6,10 +6,11 @@ Introduction\n ------------\n \n Apart from Git contrib/ area there are some others third-party tools\n-you may want to look.\n-\n+you may want to look at.\n This document presents a brief summary of each tool and the corresponding\n link.\n+For a more comprehensive list, see:\n+http://git.or.cz/gitwiki/InterfacesFrontendsAndTools\n \n \n Alternative/Augmentative Porcelains\n@@ -112,7 +113,3 @@ Others\n    This is an Emacs interface for Git. The user interface is modelled on\n    pcl-cvs. It has been developed on Emacs 21 and will probably need some\n    tweaking to work on XEmacs.\n-\n-\n-http://git.or.cz/gitwiki/InterfacesFrontendsAndTools has more\n-comprehensive list.\n-- \n2.5.0.rc3.490.g8c70279\n"},{"id":"266984","messageId":"1438113975-4915-5-git-send-email-sunshine@sunshineco.com","threadId":"39960","inReplyTo":"1438113975-4915-1-git-send-email-sunshine@sunshineco.com","subject":"[PATCH v2 4/6] Documentation/git-tools: fix item text formatting","fromName":"Eric Sunshine","fromEmail":"sunshine@sunshineco.com","sentAt":"2015-07-28T20:06:13Z","receivedAt":"2015-07-28T20:06:13Z","isPatch":true,"sender":{"key":"sunshine@sunshineco.com","avatar":"https://avatars.githubusercontent.com/u/163641?v=4"},"body":"Descriptive text for each tool item is incorrectly formatted using a\nfixed width font. Fix formatting to use a variable width font by\nunindenting the item text.\n\nSigned-off-by: Eric Sunshine <sunshine@sunshineco.com>\n---\n\nNo changes since v1.\n\n Documentation/git-tools.txt | 134 ++++++++++++++++++++++----------------------\n 1 file changed, 67 insertions(+), 67 deletions(-)\n\ndiff --git a/Documentation/git-tools.txt b/Documentation/git-tools.txt\nindex 129b8c0..ab4aab9 100644\n--- a/Documentation/git-tools.txt\n+++ b/Documentation/git-tools.txt\n@@ -16,100 +16,100 @@ http://git.or.cz/gitwiki/InterfacesFrontendsAndTools\n Alternative/Augmentative Porcelains\n -----------------------------------\n \n-   - *Cogito* (http://www.kernel.org/pub/software/scm/cogito/)\n+- *Cogito* (http://www.kernel.org/pub/software/scm/cogito/)\n++\n+Cogito is a version control system layered on top of the Git tree history\n+storage system. It aims at seamless user interface and ease of use,\n+providing generally smoother user experience than the \"raw\" Core Git\n+itself and indeed many other version control systems.\n++\n+Cogito is no longer maintained as most of its functionality\n+is now in core Git.\n \n-   Cogito is a version control system layered on top of the Git tree history\n-   storage system. It aims at seamless user interface and ease of use,\n-   providing generally smoother user experience than the \"raw\" Core Git\n-   itself and indeed many other version control systems.\n \n-   Cogito is no longer maintained as most of its functionality\n-   is now in core Git.\n+- *pg* (http://www.spearce.org/category/projects/scm/pg/)\n++\n+pg is a shell script wrapper around Git to help the user manage a set of\n+patches to files. pg is somewhat like quilt or StGit, but it does have a\n+slightly different feature set.\n \n \n-   - *pg* (http://www.spearce.org/category/projects/scm/pg/)\n-\n-   pg is a shell script wrapper around Git to help the user manage a set of\n-   patches to files. pg is somewhat like quilt or StGit, but it does have a\n-   slightly different feature set.\n-\n-\n-   - *StGit* (http://www.procode.org/stgit/)\n-\n-   Stacked Git provides a quilt-like patch management functionality in the\n-   Git environment. You can easily manage your patches in the scope of Git\n-   until they get merged upstream.\n+- *StGit* (http://www.procode.org/stgit/)\n++\n+Stacked Git provides a quilt-like patch management functionality in the\n+Git environment. You can easily manage your patches in the scope of Git\n+until they get merged upstream.\n \n \n History Viewers\n ---------------\n \n-   - *gitk* (shipped with git-core)\n-\n-   gitk is a simple Tk GUI for browsing history of Git repositories easily.\n-\n-\n-   - *gitview*  (contrib/)\n-\n-   gitview is a GTK based repository browser for Git\n+- *gitk* (shipped with git-core)\n++\n+gitk is a simple Tk GUI for browsing history of Git repositories easily.\n \n \n-   - *gitweb* (shipped with git-core)\n+- *gitview*  (contrib/)\n++\n+gitview is a GTK based repository browser for Git\n \n-   Gitweb provides full-fledged web interface for Git repositories.\n \n+- *gitweb* (shipped with git-core)\n++\n+Gitweb provides full-fledged web interface for Git repositories.\n \n-   - *qgit* (http://digilander.libero.it/mcostalba/)\n \n-   QGit is a git/StGit GUI viewer built on Qt/C++. QGit could be used\n-   to browse history and directory tree, view annotated files, commit\n-   changes cherry picking single files or applying patches.\n-   Currently it is the fastest and most feature rich among the Git\n-   viewers and commit tools.\n+- *qgit* (http://digilander.libero.it/mcostalba/)\n++\n+QGit is a git/StGit GUI viewer built on Qt/C++. QGit could be used\n+to browse history and directory tree, view annotated files, commit\n+changes cherry picking single files or applying patches.\n+Currently it is the fastest and most feature rich among the Git\n+viewers and commit tools.\n \n-   - *tig* (http://jonas.nitro.dk/tig/)\n-\n-   tig by Jonas Fonseca is a simple Git repository browser\n-   written using ncurses. Basically, it just acts as a front-end\n-   for git-log and git-show/git-diff. Additionally, you can also\n-   use it as a pager for Git commands.\n+- *tig* (http://jonas.nitro.dk/tig/)\n++\n+tig by Jonas Fonseca is a simple Git repository browser\n+written using ncurses. Basically, it just acts as a front-end\n+for git-log and git-show/git-diff. Additionally, you can also\n+use it as a pager for Git commands.\n \n \n Foreign SCM interface\n ---------------------\n \n-   - *git-svn* (shipped with git-core)\n-\n-   git-svn is a simple conduit for changesets between a single Subversion\n-   branch and Git.\n-\n-\n-   - *quilt2git / git2quilt* (http://home-tj.org/wiki/index.php/Misc)\n+- *git-svn* (shipped with git-core)\n++\n+git-svn is a simple conduit for changesets between a single Subversion\n+branch and Git.\n \n-   These utilities convert patch series in a quilt repository and commit\n-   series in Git back and forth.\n \n+- *quilt2git / git2quilt* (http://home-tj.org/wiki/index.php/Misc)\n++\n+These utilities convert patch series in a quilt repository and commit\n+series in Git back and forth.\n \n-   - *hg-to-git* (contrib/)\n \n-   hg-to-git converts a Mercurial repository into a Git one, and\n-   preserves the full branch history in the process. hg-to-git can\n-   also be used in an incremental way to keep the Git repository\n-   in sync with the master Mercurial repository.\n+- *hg-to-git* (contrib/)\n++\n+hg-to-git converts a Mercurial repository into a Git one, and\n+preserves the full branch history in the process. hg-to-git can\n+also be used in an incremental way to keep the Git repository\n+in sync with the master Mercurial repository.\n \n \n Others\n ------\n \n-   - *(h)gct* (http://www.cyd.liu.se/users/~freku045/gct/)\n-\n-   Commit Tool or (h)gct is a GUI enabled commit tool for Git and\n-   Mercurial (hg). It allows the user to view diffs, select which files\n-   to committed (or ignored / reverted) write commit messages and\n-   perform the commit itself.\n-\n-   - *git.el* (contrib/)\n-\n-   This is an Emacs interface for Git. The user interface is modelled on\n-   pcl-cvs. It has been developed on Emacs 21 and will probably need some\n-   tweaking to work on XEmacs.\n+- *(h)gct* (http://www.cyd.liu.se/users/~freku045/gct/)\n++\n+Commit Tool or (h)gct is a GUI enabled commit tool for Git and\n+Mercurial (hg). It allows the user to view diffs, select which files\n+to committed (or ignored / reverted) write commit messages and\n+perform the commit itself.\n+\n+- *git.el* (contrib/)\n++\n+This is an Emacs interface for Git. The user interface is modelled on\n+pcl-cvs. It has been developed on Emacs 21 and will probably need some\n+tweaking to work on XEmacs.\n-- \n2.5.0.rc3.490.g8c70279\n"},{"id":"266983","messageId":"1438113975-4915-6-git-send-email-sunshine@sunshineco.com","threadId":"39960","inReplyTo":"1438113975-4915-1-git-send-email-sunshine@sunshineco.com","subject":"[PATCH v2 5/6] Documentation/git-tools: drop references to defunct tools","fromName":"Eric Sunshine","fromEmail":"sunshine@sunshineco.com","sentAt":"2015-07-28T20:06:14Z","receivedAt":"2015-07-28T20:06:14Z","isPatch":true,"sender":{"key":"sunshine@sunshineco.com","avatar":"https://avatars.githubusercontent.com/u/163641?v=4"},"body":"Cogito -- unmaintained since late 2006[1]\npg -- URL dead; web searches reveal no information\nquilt2git -- URL dead; web searches reveal no information\n(h)gct -- URL dead; no repository activity since 2007[2]\n\n[1]: http://git.or.cz/cogito/\n[2]: http://repo.or.cz/w/hgct.git\n\nSigned-off-by: Eric Sunshine <sunshine@sunshineco.com>\n---\n\nNo changes since v1.\n\n Documentation/git-tools.txt | 31 -------------------------------\n 1 file changed, 31 deletions(-)\n\ndiff --git a/Documentation/git-tools.txt b/Documentation/git-tools.txt\nindex ab4aab9..48a3595 100644\n--- a/Documentation/git-tools.txt\n+++ b/Documentation/git-tools.txt\n@@ -16,24 +16,6 @@ http://git.or.cz/gitwiki/InterfacesFrontendsAndTools\n Alternative/Augmentative Porcelains\n -----------------------------------\n \n-- *Cogito* (http://www.kernel.org/pub/software/scm/cogito/)\n-+\n-Cogito is a version control system layered on top of the Git tree history\n-storage system. It aims at seamless user interface and ease of use,\n-providing generally smoother user experience than the \"raw\" Core Git\n-itself and indeed many other version control systems.\n-+\n-Cogito is no longer maintained as most of its functionality\n-is now in core Git.\n-\n-\n-- *pg* (http://www.spearce.org/category/projects/scm/pg/)\n-+\n-pg is a shell script wrapper around Git to help the user manage a set of\n-patches to files. pg is somewhat like quilt or StGit, but it does have a\n-slightly different feature set.\n-\n-\n - *StGit* (http://www.procode.org/stgit/)\n +\n Stacked Git provides a quilt-like patch management functionality in the\n@@ -84,12 +66,6 @@ git-svn is a simple conduit for changesets between a single Subversion\n branch and Git.\n \n \n-- *quilt2git / git2quilt* (http://home-tj.org/wiki/index.php/Misc)\n-+\n-These utilities convert patch series in a quilt repository and commit\n-series in Git back and forth.\n-\n-\n - *hg-to-git* (contrib/)\n +\n hg-to-git converts a Mercurial repository into a Git one, and\n@@ -101,13 +77,6 @@ in sync with the master Mercurial repository.\n Others\n ------\n \n-- *(h)gct* (http://www.cyd.liu.se/users/~freku045/gct/)\n-+\n-Commit Tool or (h)gct is a GUI enabled commit tool for Git and\n-Mercurial (hg). It allows the user to view diffs, select which files\n-to committed (or ignored / reverted) write commit messages and\n-perform the commit itself.\n-\n - *git.el* (contrib/)\n +\n This is an Emacs interface for Git. The user interface is modelled on\n-- \n2.5.0.rc3.490.g8c70279\n"},{"id":"266985","messageId":"1438113975-4915-7-git-send-email-sunshine@sunshineco.com","threadId":"39960","inReplyTo":"1438113975-4915-1-git-send-email-sunshine@sunshineco.com","subject":"[PATCH v2 6/6] Documentation/git-tools: retire manually-maintained list","fromName":"Eric Sunshine","fromEmail":"sunshine@sunshineco.com","sentAt":"2015-07-28T20:06:15Z","receivedAt":"2015-07-28T20:06:15Z","isPatch":true,"sender":{"key":"sunshine@sunshineco.com","avatar":"https://avatars.githubusercontent.com/u/163641?v=4"},"body":"When Git was young, people looking for third-party Git-related tools\ncame to the Git project itself to find them, so it made sense to\nmaintain a list of tools here. These days, however, search engines fill\nthat role much more efficiently, so retire the manually-maintained\nlist.\n\nThe list of front-ends and tools on the Git wiki rates perhaps a distant\nsecond to search engines, and may still have value, so retain a\nreference to it.\n\nSigned-off-by: Eric Sunshine <sunshine@sunshineco.com>\n---\n\nNew in v2. This is plopped at the end of the series, rather than being\nincorporated into it more fully, so that it can be dropped easily in\ncase it is decided that there is still some merit to having a manually-\nmaintained list.\n\n Documentation/git-tools.txt | 88 ++++-----------------------------------------\n 1 file changed, 7 insertions(+), 81 deletions(-)\n\ndiff --git a/Documentation/git-tools.txt b/Documentation/git-tools.txt\nindex 48a3595..2f4ff50 100644\n--- a/Documentation/git-tools.txt\n+++ b/Documentation/git-tools.txt\n@@ -1,84 +1,10 @@\n-A short Git tools survey\n-========================\n+Git Tools\n+=========\n \n+When Git was young, people looking for third-party Git-related tools came\n+to the Git project itself to find them, thus a list of such tools was\n+maintained here. These days, however, search engines fill that role much\n+more efficiently, so this manually-maintained list has been retired.\n \n-Introduction\n-------------\n-\n-Apart from Git contrib/ area there are some others third-party tools\n-you may want to look at.\n-This document presents a brief summary of each tool and the corresponding\n-link.\n-For a more comprehensive list, see:\n+See also the `contrib/` area, and the Git wiki:\n http://git.or.cz/gitwiki/InterfacesFrontendsAndTools\n-\n-\n-Alternative/Augmentative Porcelains\n------------------------------------\n-\n-- *StGit* (http://www.procode.org/stgit/)\n-+\n-Stacked Git provides a quilt-like patch management functionality in the\n-Git environment. You can easily manage your patches in the scope of Git\n-until they get merged upstream.\n-\n-\n-History Viewers\n----------------\n-\n-- *gitk* (shipped with git-core)\n-+\n-gitk is a simple Tk GUI for browsing history of Git repositories easily.\n-\n-\n-- *gitview*  (contrib/)\n-+\n-gitview is a GTK based repository browser for Git\n-\n-\n-- *gitweb* (shipped with git-core)\n-+\n-Gitweb provides full-fledged web interface for Git repositories.\n-\n-\n-- *qgit* (http://digilander.libero.it/mcostalba/)\n-+\n-QGit is a git/StGit GUI viewer built on Qt/C++. QGit could be used\n-to browse history and directory tree, view annotated files, commit\n-changes cherry picking single files or applying patches.\n-Currently it is the fastest and most feature rich among the Git\n-viewers and commit tools.\n-\n-- *tig* (http://jonas.nitro.dk/tig/)\n-+\n-tig by Jonas Fonseca is a simple Git repository browser\n-written using ncurses. Basically, it just acts as a front-end\n-for git-log and git-show/git-diff. Additionally, you can also\n-use it as a pager for Git commands.\n-\n-\n-Foreign SCM interface\n----------------------\n-\n-- *git-svn* (shipped with git-core)\n-+\n-git-svn is a simple conduit for changesets between a single Subversion\n-branch and Git.\n-\n-\n-- *hg-to-git* (contrib/)\n-+\n-hg-to-git converts a Mercurial repository into a Git one, and\n-preserves the full branch history in the process. hg-to-git can\n-also be used in an incremental way to keep the Git repository\n-in sync with the master Mercurial repository.\n-\n-\n-Others\n-------\n-\n-- *git.el* (contrib/)\n-+\n-This is an Emacs interface for Git. The user interface is modelled on\n-pcl-cvs. It has been developed on Emacs 21 and will probably need some\n-tweaking to work on XEmacs.\n-- \n2.5.0.rc3.490.g8c70279\n"}]}