Teemu Likonen <tlikonen@xxxxxx> writes:
> $ git
> usage: [...]
>
> The most commonly used git commands are:
> [There's no "help" command in the list.]
>
> I think it belongs there,...
While I do agree that a word 'help' should appear in the above output
somewhere, it is a horrible idea to place it in "list of common commands"
for two reasons.
(1) nobody keeps typing "git help". The reason we may want to mention
'help' in this output is not because it is common;
(2) 'help' _is_ different from other commands. It is something one may
want to know the presense of when one is still lost after seeing the
above quoted output, especially when one is starting to learn. It
makes it more difficult to spot it if you bury it as one of the
commands in a list.
It is reasonable to mention 'help' somewhere in the output, but if we are
going to do this, we should make it stand out. Perhaps like this.
-- >8 --
$ git
usage: git [--version] ...
The most commonly used git commands are:
add Add file contents to the index
bisect Find the change that introduced a bug by binary search
branch List, create, or delete branches
...
show Show various types of objects
status Show the working tree status
tag Create, list, delete or verify a tag object signed with GPG
See 'man git' and 'git help' for more information.
-- 8< --
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
