[PATCH] Add subcommand "help" to the list of most commonly used subcommands

Previous message: [thread] [date] [author]
Next message: [thread] [date] [author]
From: Teemu Likonen
Date: Thursday, June 5, 2008 - 1:19 am

Johannes Schindelin wrote (2008-06-05 07:48 +0100):


A side note: The following three commands seem to do exactly the same:

  $ git --help log
  $ git log --help
  $ git help log

Which in itself is good, I think, since in all the cases user expects to
get the manual for "log". It seems that "git help <command>" is the most
often advertised in manuals and tutorials but it does not show in the
list printed by "git / git --help / git help":

  $ git
  usage: [...]

  The most commonly used git commands are:
  [There's no "help" command in the list.]

I think it belongs there, so how about the following patch? There are
two logically separate changes but I didn't feel that they deserve
separate commits.

---snip---
Add subcommand "help" to the list of most commonly used subcommands

Commands "git", "git --help" and "git help" did not list the subcommand
"help" as one of the most commonly used git commands. Yet "git help" is
advertised as the help command of git so this patch adds "help" the
list.

In addition to that change the short description in git-help.txt manual
to start with a capital letter.

Signed-off-by: Teemu Likonen <tlikonen@iki.fi>
---
 Documentation/git-help.txt |    2 +-
 command-list.txt           |    2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/Documentation/git-help.txt b/Documentation/git-help.txt
index bfbba9e..4d3613c 100644
--- a/Documentation/git-help.txt
+++ b/Documentation/git-help.txt
@@ -3,7 +3,7 @@ git-help(1)
 
 NAME
 ----
-git-help - display help information about git
+git-help - Display help information about git
 
 SYNOPSIS
 --------
diff --git a/command-list.txt b/command-list.txt
index 3583a33..510ac69 100644
--- a/command-list.txt
+++ b/command-list.txt
@@ -47,7 +47,7 @@ git-get-tar-commit-id                   ancillaryinterrogators
 git-grep                                mainporcelain common
 git-gui                                 mainporcelain
 git-hash-object                         plumbingmanipulators
-git-help				ancillaryinterrogators
+git-help				ancillaryinterrogators common
 git-http-fetch                          synchelpers
 git-http-push                           synchelpers
 git-imap-send                           foreignscminterface
-- 
1.5.6.rc1.15.gc0c85

--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Previous message: [thread] [date] [author]
Next message: [thread] [date] [author]

Messages in current thread:
[TOY PATCH] git wrapper: show similar command names for an ..., Johannes Schindelin, (Wed Jun 4, 11:48 pm)
[PATCH] Add subcommand "help" to the list of most commonly ..., Teemu Likonen, (Thu Jun 5, 1:19 am)
Re: [TOY PATCH] git wrapper: show similar command names fo ..., Johannes Schindelin, (Thu Jun 5, 4:00 pm)
Re: [TOY PATCH] git wrapper: show similar command names fo ..., Johannes Schindelin, (Sat Jun 7, 8:04 am)
Re: [TOY PATCH] git wrapper: show similar command names fo ..., Johannes Schindelin, (Sun Jun 8, 8:07 am)
Re: [TOY PATCH] git wrapper: show similar command names fo ..., Johannes Schindelin, (Sun Jun 8, 4:26 pm)