From: Stefan Beller <stefanbeller@googlemail.com>
To: Stefan Beller <stefanbeller@googlemail.com>,
tr@thomasrast.ch, mhagger@alum.mit.edu, git@vger.kernel.org
Subject: Re: [PATCH] Documentation: add a script to generate a (long/short) options overview
Date: Fri, 01 Nov 2013 00:09:10 +0100 [thread overview]
Message-ID: <5272E316.5090108@googlemail.com> (raw)
In-Reply-To: <1383260682-12364-1-git-send-email-stefanbeller@googlemail.com>
On 11/01/2013 12:04 AM, Stefan Beller wrote:
> Recently a discussion started on the mailing list, which short option
> shall be best for a long option. (-f being always --force and therefore
> should not be reassigned another meaning in one particular command)
> See http://www.mail-archive.com/git@vger.kernel.org/msg38456.html
>
> For discussions as these we need a script to easily generate an
> overview of all available one letter options, and their long option
> equivalents.
>
> As the list of options was not retrieved fully automated,
> there might be minor errors or missing items.
>
> Signed-off-by: Stefan Beller <stefanbeller@googlemail.com>
> ---
> Documentation/generateShortOptions.py | 460 ++++++++++++++++++++++++++++++++++
> 1 file changed, 460 insertions(+)
> create mode 100644 Documentation/generateShortOptions.py
>
When trying to send a follow-up patch with the table itself, I got:
fatal: /tmp/wHpJlnf1r5/0002-Documentation-add-table-viewing-short-long-options-f.patch: 19: patch contains a line longer than 998 characters
warning: no patches were sent
Is this an artifical limitation or something that actually makes sense?
Anyway here is the table, updated to carry more commands and sorted:
>From 7d2ba0af3500f1629783dfc80aafe218dee8618c Mon Sep 17 00:00:00 2001
From: Stefan Beller <stefanbeller@googlemail.com>
Date: Fri, 1 Nov 2013 00:01:21 +0100
Subject: [PATCH 2/2] Documentation: add table viewing (short/long) options for
all commands
Signed-off-by: Stefan Beller <stefanbeller@googlemail.com>
---
Documentation/ShortOptions.txt | 73 ++++++++++++++++++++++++++++++++++++++++++
1 file changed, 73 insertions(+)
create mode 100644 Documentation/ShortOptions.txt
diff --git a/Documentation/ShortOptions.txt b/Documentation/ShortOptions.txt
new file mode 100644
index 0000000..dd76512
--- /dev/null
+++ b/Documentation/ShortOptions.txt
@@ -0,0 +1,73 @@
+ Name\short | q | v | n | s | f | m | u | a | p | e | l | X | i | n | p | d | u | o | f | F | c | t | z | a | b | q | A | N | k | i | s | 3 | C | S | b | g | r | w | B | C | D | M | U | W | c | e | k | m | r | v | w | 2 |
B | E | G | H | L | O | P | R | W | x | 3 | E |
F | N | d | g | h | l | t | x
+ add | | verbose | dry-run | | force | | update | | patch | edit | | | interactive | | | | | | | | | | | | | | all | intent-to-add | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | add
+ am | | | | | | | | | | | | | | | | | utf8 | | | | | | | | | quiet | | | | interactive | signoff | | | | | | | | | | | | | | | | keep | | | | | |
| | | | | | | | | | 3way | |
| | | | | | | am
+ annotate | | | | | | | | | | | | | | | porcelain | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | annotate
+ apply | | verbose | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 3way | | | | | | | | | | | | | | | | | | | | |
| | | | | | | reverse | | | | |
| | | | | | | apply
+ archive | | | | | | | | | | | | | | | | | | output | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | archive
+ blame | | | | | | | | | | | | | | show-number | porcelain | | | | show-name | | | | | | | | | | | | | | | | | | | | | | | | | | | show-email | | | | | | |
| | | | | | | | | | | |
| | | | | | | blame
+ branch | quiet | verbose | | | force | move | set-upstream-to | all | | | create-reflog | | | | | delete | | | | | | track | | | | | | | | | | | | | | | remotes | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | branch
+ check-attr | | | | | | | | all | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | check-attr
+ check-ignore | quiet | verbose | non-matching | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | check-ignore
+ checkout | quiet | | | | force | merge | | | patch | | | | | | | | | | | | | track | | | | | | | | | | theirs | | | | | | | | | | | | | | | | | | | | ours |
| | | | | | | | | | | |
| | | | | | | checkout
+ checkout-index | quiet | | no-create | | force | | index | all | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | checkout-index
+ cherry | | verbose | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | cherry
+ cherry-pick | | | no-commit | signoff | | mainline | | | | edit | | strategy-option | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | cherry-pick
+ clean | quiet | | dry-run | | force | | | | | exclude | | | interactive | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | clean
+ clone | quiet | verbose | no-checkout | shared | | | upload-pack | | | | local | | | | | | | origin | | | config | | | | | | | | | | | | | | branch | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | clone
+ commit | quiet | verbose | no-verify | signoff | | message | untracked-files | all | patch | edit | | | include | | | | | only | | file | reedit-message | template | null | | | | | | | | | | reuse-message | gpg-sign | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | commit
+ config | | | | | file | | | | | edit | list | | | | | | | | | | | | null | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | config
+ count-objects | | verbose | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | human-readable | | | | | | | | |
| | | | | | | count-objects
+ diff | | | | | | | | | | | | | | | patch | | patch | | | | | | | text | ignore-space-change | | | | | | | | | | | | | | break-rewrites | find-copies | irreversible-delete | find-renames | unified | function-context | | | | | | | ignore-all-space | |
| | | | | | | | | | | |
| | | | | | | diff
+ diff-files | | | | | | | | | | | | | | | patch | | patch | | | | | | | text | ignore-space-change | | | | | | | | | | | | | | break-rewrites | find-copies | irreversible-delete | find-renames | unified | function-context | cc | | | | | | ignore-all-space | |
| | | | | | | | | | | |
| | | | | | | diff-files
+ fetch | quiet | verbose | | | force | multiple | update-head-ok | append | prune | | | | | | | | | | | | | tags | | | | | | | keep | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | fetch
+ filter-branch | | | | | | | | | | | | | | | | | | | force | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | filter-branch
+ fmt-merge-msg | | | | | | message | | | | | | | | | | | | | | file | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | fmt-merge-msg
+ for-each-ref | | | | shell | | | | | perl | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | for-each-ref
+ format-patch | quiet | reroll-count | numbered | signoff | | | | | no-stat | | | | | | | | | output-directory | | | | | | | | | | no-numbered | keep-subject | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | format-patch
+ fsck | | verbose | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | fsck
+ fsck-objects | | verbose | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | fsck-objects
+ gc | quiet | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | gc
+ grep | quiet | invert-match | line-number | | | | | text | show-function | | files-with-matches | | ignore-case | | | | | | | fixed-strings | count | | null | | | | after-context | | | | | | context | | | | | word-regexp | | | | | | | | | | | | | | |
before-context | extended-regexp | basic-regexp | | files-without-match | open-files-in-pager | perl-regexp | | function-context | | | |
| | | | | | | grep
+ help | | | | | | man | | all | | | | | info | | | | | | | | | | | | | | | | | | | | | | | guides | | web | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | help
+ init | quiet | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | init
+ init-db | quiet | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | init-db
+ insta-web | | | | | | | | | | | | | | | port | | | | | | | | | | browser | | | | | | | | | | | | | | | | | | | | | | | module-path | | | | |
| | | | | | | | | | | |
| | httpd | | | local | | insta-web
+ log | quiet | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | log
+ ls-files | | | | stage | | modified | unmerged | | | | | exclude-from | ignored | | | deleted | | others | | | cached | | | | | | | | killed | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | exclude | | |
| | | | | | | ls-files
+ ls-remotes | | | | | | | | | | | | | | | | | upload-pack | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | heads | | tags | ls-remotes
+ ls-tree | | | | | | | | | | | long | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | ls-tree
+ merge | quiet | verbose | no-stat | strategy | | message | | | | edit | | strategy-option | | | | | | | | | | | | | | | | | | | | | | gpg-sign | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | merge
+ merge-base | | | | | | | | all | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | merge-base
+ merge-file | quiet | | | | | | | | stdout | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | merge-file
+ mv | | verbose | dry-run | | force | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | mv
+ pack-objects | quiet | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | pack-objects
+ prune | | verbose | dry-run | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | prune
+ prune-packed | quiet | | dry-run | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | prune-packed
+ pull | | | | strategy | | | | | | | | strategy-option | | no-stat | | | update-head-ok | | force | | | | | append | | quiet | | | | | | | | | | | | | | | | | | | | | keep | | rebase | verbose | | |
| | | | | | | | | | | |
| | | | | | | pull
+ push | quiet | verbose | dry-run | | force | | set-upstream | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | push
+ quilt-import | | | | | | | | | | | | | | dry-run | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | quilt-import
+ read-tree | | verbose | dry-run | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | read-tree
+ rebase | | | | strategy | | | | | | | | strategy-option | | no-stat | preserve-merges | | | | force-rebase | | | | | | | | | | | interactive | | | | | | | | | | | | | | | | | | merge | rebase | verbose | | |
| | | | | | | | | | | |
| | | | | | | exec rebase
+ reflog | quiet | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | reflog
+ remote | | verbose | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | remote
+ repack | quiet | | | | | | | | | | local | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | repack
+ replace | | | | | force | | | | | | list | | | | | delete | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | replace
+ reset | quiet | | | | | | | | patch | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | reset
+ rev-list | | | | | | | | | | | | | | max-count | | | | | | | | | | | | | | | | regexp-ignore-case | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | extended-regexp |
fixed-strings | | | walk-reflogs | | | | rev-list
+ revert | | | no-commit | signoff | | mainline | | | | edit | | strategy-option | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | revert
+ rm | quiet | | dry-run | | force | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | rm
+ shortlog | | | | | | | | | | | | | | numbered | | | | | | | | | | | | | | | | | summary | | | | | | | | | | | | | | | email | | | | | | |
| | | | | | | | | | | |
| | | | | | | shortlog
+ show | quiet | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | show
+ show-branch | | | | | | | | all | | | | | | | | | | | | | | | | | | | | | | | | | | | | reflog | remotes | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | show-branch
+ show-ref | quiet | | | hash | | | | | | | | | | | | dereference | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | show-ref
+ stage | | verbose | dry-run | | force | | update | | patch | edit | | | interactive | | | | | | | | | | | | | | all | intent-to-add | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | stage
+ stash | | | | | | | | | | | | | | | patch | | include-untracked | | | | | | | all | | quiet | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | stash
+ status | | verbose | | short | | | untracked-files | | | | | | | | | | | | | | | | null | | | | | | | | | | | | branch | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | status
+ stripspace | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | strip-comments | | | | | | | | | | | | | | comment-lines | | | | | | | |
| | | | | | | | | | | |
| | | | | | | stripspace
+ submodule | | | | | | | | | | | | | | summary-limit | | | | | force | | | | | | branch | quiet | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| no-fetch | | | | | | submodule
+ symbolic-ref | quiet | | | | | | | | | | | | | | | delete | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | symbolic-ref
+ tag | | verify | | sign | force | message | local-user | annotate | | | list | | | | | delete | | | | file | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | tag
+ update-server-info | | | | | force | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | update-server-info
+ verify-pack | | verbose | | stat-only | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | verify-pack
+ verify-tag | | verbose | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | verify-tag
+ whatchanged | quiet | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | |
| | | | | | | whatchanged
--
1.8.4.1.605.g23c6912
next prev parent reply other threads:[~2013-10-31 23:09 UTC|newest]
Thread overview: 49+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <20131024122255.GI9378@mwanda>
[not found] ` <20131024122512.GB9534@mwanda>
[not found] ` <20131026181709.GB10488@kroah.com>
2013-10-27 1:34 ` [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line Josh Triplett
2013-10-27 5:42 ` Michael Haggerty
2013-10-27 6:37 ` Theodore Ts'o
2013-10-27 7:14 ` Josh Triplett
2013-10-27 8:03 ` [Ksummit-2013-discuss] " Michel Lespinasse
2013-10-27 9:23 ` Josh Triplett
2013-10-27 8:09 ` Thomas Rast
2013-10-27 9:20 ` Josh Triplett
2013-10-27 10:59 ` Johan Herland
2013-10-27 19:10 ` Christian Couder
2013-10-28 2:46 ` Johan Herland
2013-10-28 22:10 ` Thomas Rast
2013-10-29 2:02 ` Jeff King
2013-10-30 17:53 ` Johan Herland
2013-10-29 6:23 ` Christian Couder
2013-10-30 19:07 ` Johan Herland
2013-11-02 12:54 ` Christian Couder
2013-10-27 9:26 ` Stefan Beller
2013-10-27 16:30 ` Thomas Rast
2013-10-27 17:03 ` Stefan Beller
2013-10-31 23:03 ` Stefan Beller
2013-10-31 23:04 ` [PATCH] Documentation: add a script to generate a (long/short) options overview Stefan Beller
2013-10-31 23:09 ` Stefan Beller [this message]
2013-10-31 23:45 ` brian m. carlson
2013-11-01 0:09 ` Junio C Hamano
2013-10-28 9:02 ` [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line Michael Haggerty
2013-10-28 11:29 ` Johan Herland
2013-10-29 2:08 ` Jeff King
2013-10-29 8:26 ` Matthieu Moy
2013-10-30 18:12 ` Johan Herland
2013-10-31 6:28 ` Duy Nguyen
2013-10-31 17:20 ` Junio C Hamano
2013-10-31 23:52 ` Duy Nguyen
2013-11-01 0:16 ` Johan Herland
2013-10-27 8:33 ` Duy Nguyen
2013-10-27 9:13 ` Josh Triplett
2013-10-28 0:49 ` Jim Hill
2013-10-28 1:52 ` Junio C Hamano
2013-10-28 7:16 ` Josh Triplett
2013-10-28 8:27 ` Michael Haggerty
2013-10-28 8:59 ` [ksummit-attendees] " Christoph Hellwig
2013-10-28 23:09 ` Benjamin Herrenschmidt
2013-10-28 23:38 ` Russell King - ARM Linux
2013-10-28 23:41 ` Russell King - ARM Linux
2013-10-28 9:08 ` Junio C Hamano
2013-10-29 4:45 ` Christian Couder
2013-10-29 19:54 ` Junio C Hamano
2013-10-30 17:28 ` Tony Luck
2013-10-30 18:33 ` Junio C Hamano
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: http://vger.kernel.org/majordomo-info.html
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=5272E316.5090108@googlemail.com \
--to=stefanbeller@googlemail.com \
--cc=git@vger.kernel.org \
--cc=mhagger@alum.mit.edu \
--cc=tr@thomasrast.ch \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://80x24.org/mirrors/git.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).