git-stash: improve synopsis in help and manual page
authorStephan Beyer <s-beyer@gmx.net>
Sat, 16 Aug 2008 03:27:31 +0000 (05:27 +0200)
committerJunio C Hamano <gitster@pobox.com>
Sat, 16 Aug 2008 09:58:18 +0000 (02:58 -0700)
commita5ab00c5d20cee04ce181bb5a6c3ca5d923744a4
tree24183276621c341e0a0b9a66c4518437d77c1756
parent0d768f7c8f1b38ba14bbd5a2dfc4d56ae5eb4ad8
git-stash: improve synopsis in help and manual page

"git stash -h" showed some incomplete and ugly usage information.
For example, the useful "--keep-index" option for "save" or the "--index"
option for  "apply" were not shown. Also in the documentation synopsis they
were not shown, so that there is no incentive to scroll down and even see
that such options exist.

This patch improves the git-stash synopsis in the documentation by
mentioning that further options to the stash commands and then copies
this synopsis to the usage information string of git-stash.sh.

For the latter, the dashless git command string has to be inserted on the
second and the following usage lines. The code of this is taken from
git-sh-setup so that all lines will show the command string.

Note that the "create" command is not advertised at all now, because
it was not mentioned in git-stash.txt.

Signed-off-by: Stephan Beyer <s-beyer@gmx.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-stash.txt
git-stash.sh