Control: tags 852979 + patch upstream pending
Hi Ulyanich Michael--
On Sat 2017-01-28 12:02:58 -0500, Ulyanich Michael wrote:
> from "man gpg":
> ***
> Commands not specific to the function
>
> --version
> Print the program version and licensing information. Note that
> you cannot abbreviate this command.
>
> --help
> -h Print a usage message summarizing the most useful command-line
> options. Note that you cannot abbreviate this command.
>
> ***
> But as i understand, -h is an abbrebiation of the command "--help". Thus, it
> shouldn't be the sentence "Note that you cannot abbreviate this command."
i can see why that sounds a bit confusing, but -h is a "short" command,
and --help is a "long" command. gpg offers abbreviations of most long
commands, so that (for example) you can use "--bat" as a long-option
abbreviation for the "--batch".
So this is the manual telling you that gpg won't accept "--hel" instead
of "--help".
Confusing, though!
I'm attaching a patch which i've also pushed upstream.
--dkg
>From 9f0a6a5d0f9e79a1f6d9d500c378ede73663f41b Mon Sep 17 00:00:00 2001
From: Daniel Kahn Gillmor <d...@fifthhorseman.net>
Date: Sat, 4 Feb 2017 01:28:08 -0500
Subject: [PATCH 2/2] doc: Clarify abbreviation of --help.
* doc/gpg.texi: clarify abbreviation of --help.
Debian-bug-id: 852979
Signed-off-by: Daniel Kahn Gillmor <d...@fifthhorseman.net>
---
doc/gpg.texi | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/doc/gpg.texi b/doc/gpg.texi
index 8e1a5e6fc..b79b78334 100644
--- a/doc/gpg.texi
+++ b/doc/gpg.texi
@@ -141,7 +141,8 @@ cannot abbreviate this command.
@itemx -h
@opindex help
Print a usage message summarizing the most useful command-line options.
-Note that you cannot abbreviate this command.
+Note that you cannot arbitrarily abbreviate this command
+(though you can use its short form @option{-h}).
@item --warranty
@opindex warranty
--
2.11.0
