git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH] use -h for synopsis and --help for manpage consistently

From
Clemens Buchacher <drizzd@aon.at>
Date
Sep 23, 2011, 11:55 UTC
Message-ID
<20110923115512.GB12122@ecki.lan>
In-Reply-To
<7vaa9xyxpf.fsf@alter.siamese.dyndns.org>
Signed-off-by: Clemens Buchacher <drizzd@aon.at>
---
On Wed, Sep 21, 2011 at 10:04:28PM -0700, Junio C Hamano wrote:
Show 7 quoted lines
> 
> * cb/send-email-help (2011-09-12) 1 commit
>   (merged to 'next' on 2011-09-14 at ae71999)
>  + send-email: add option -h
> 
> A separate set of patches to remove the hidden fully-spelled "help" from
> other commands would be nice to have as companion patches as well.
This should do it.
Clemens
 Documentation/blame-options.txt |    1 -
 git-cvsserver.perl              |    4 ++--
 git-difftool.perl               |    2 +-
 git-pull.sh                     |    2 +-
 git-sh-setup.sh                 |    2 +-
 git-svn.perl                    |    2 +-
 6 files changed, 6 insertions(+), 7 deletions(-)
diff --git a/Documentation/blame-options.txt b/Documentation/blame-options.txt
index e76195a..d4a51da 100644
--- a/Documentation/blame-options.txt
+++ b/Documentation/blame-options.txt
@@ -117,5 +117,4 @@ commit. And the default value is 40. If there are more than one
 take effect.
 
 -h::
---help::
 	Show help message.
diff --git a/git-cvsserver.perl b/git-cvsserver.perl
index 1b8bff2..6c5185e 100755
--- a/git-cvsserver.perl
+++ b/git-cvsserver.perl
@@ -109,14 +109,14 @@ my $usage =
     "    --strict-paths      : Don't allow recursing into subdirectories\n".
     "    --export-all        : Don't check for gitcvs.enabled in config\n".
     "    --version, -V       : Print version information and exit\n".
-    "    --help, -h, -H      : Print usage information and exit\n".
+    "    -h                  : Print usage information and exit\n".
     "\n".
     "<directory> ... is a list of allowed directories. If no directories\n".
     "are given, all are allowed. This is an additional restriction, gitcvs\n".
     "access still needs to be enabled by the gitcvs.enabled config option.\n".
     "Alternately, one directory may be specified in GIT_CVSSERVER_ROOT.\n";
 
-my @opts = ( 'help|h|H', 'version|V',
+my @opts = ( 'h', 'version|V',
 	     'base-path=s', 'strict-paths', 'export-all' );
 GetOptions( $state, @opts )
     or die $usage;
diff --git a/git-difftool.perl b/git-difftool.perl
index ced1615..09b65f1 100755
--- a/git-difftool.perl
+++ b/git-difftool.perl
@@ -97,7 +97,7 @@ sub generate_command
 			$prompt = 'yes';
 			next;
 		}
-		if ($arg eq '-h' || $arg eq '--help') {
+		if ($arg eq '-h') {
 			usage();
 		}
 		push @command, $arg;
diff --git a/git-pull.sh b/git-pull.sh
index 63da37b..8c1370f 100755
--- a/git-pull.sh
+++ b/git-pull.sh
@@ -120,7 +120,7 @@ do
 	--d|--dr|--dry|--dry-|--dry-r|--dry-ru|--dry-run)
 		dry_run=--dry-run
 		;;
-	-h|--h|--he|--hel|--help|--help-|--help-a|--help-al|--help-all)
+	-h|--help-all)
 		usage
 		;;
 	*)
diff --git a/git-sh-setup.sh b/git-sh-setup.sh
index 8e427da..1fba6c2 100644
--- a/git-sh-setup.sh
+++ b/git-sh-setup.sh
@@ -90,7 +90,7 @@ $LONG_USAGE"
 	fi
 
 	case "$1" in
-		-h|--h|--he|--hel|--help)
+		-h)
 		echo "$LONG_USAGE"
 		exit
 	esac
diff --git a/git-svn.perl b/git-svn.perl
index 89f83fd..a019f55 100755
--- a/git-svn.perl
+++ b/git-svn.perl
@@ -294,7 +294,7 @@ read_git_config(\%opts);
 if ($cmd && ($cmd eq 'log' || $cmd eq 'blame')) {
 	Getopt::Long::Configure('pass_through');
 }
-my $rv = GetOptions(%opts, 'help|H|h' => \$_help, 'version|V' => \$_version,
+my $rv = GetOptions(%opts, 'h' => \$_help, 'version|V' => \$_version,
                     'minimize-connections' => \$Git::SVN::Migration::_minimize,
                     'id|i=s' => \$Git::SVN::default_ref_id,
                     'svn-remote|remote|R=s' => sub {
-- 
1.7.6.1
Previous: Clemens BuchacherNext: Scott Chacon
Message 10 of 19 in “What's cooking in git.git (Sep 2011, #06; Wed, 21)”
  1. Junio C HamanoSep 22, 2011
  2. Carlos Martín NietoSep 22, 2011
  3. Michael SchubertSep 22, 2011
  4. Junio C HamanoSep 22, 2011
  5. Jakub NarebskiSep 22, 2011
  6. Junio C HamanoSep 22, 2011
  7. Jakub NarebskiSep 22, 2011
  8. Junio C HamanoSep 22, 2011
  9. fix push --quiet: add 'quiet' capability to receive-packClemens Buchacher, Sep 23, 2011
  10. use -h for synopsis and --help for manpage consistentlyClemens Buchacher, Sep 23, 2011
  11. Scott ChaconSep 23, 2011
  12. Junio C HamanoSep 23, 2011
  13. Junio C HamanoSep 23, 2011
  14. Scott ChaconSep 26, 2011
  15. Junio C HamanoSep 26, 2011
  16. Jay SoffianSep 27, 2011
  17. fix push --quiet: add 'quiet' capability to receive-packClemens Buchacher, Oct 5, 2011
  18. Junio C HamanoOct 3, 2011
  19. Clemens BuchacherOct 5, 2011

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.