Re: [PATCH] Document git-stash

[Johannes Schindelin <Johannes.Schindelin@gmx.de>]

Hi,

On Sun, 1 Jul 2007, Junio C Hamano wrote:

> Jeff King <peff@peff.net> writes:
> 
> >> +(no subcommand)::
> >> +
> >> +	Save your local modifications to a new 'stash', and run `git-reset
> >> +	--hard` to revert them.
> >
> > For orthogonality's sake, should this be 'git-stash save', aliased to
> > just 'git-stash'? It would make this heading a little more intuitive,
> > and the very first paragraph (describing all of the modes) a little more
> > clear.
> 
> I would further suggest that we _require_ 'git stash save' to
> create a new one and perhaps make the non-subcommand case run
> 'git stash list'.  While I was trying the code out I
> accidentally created a new stash when I did not mean to, which
> pushed the stash I wanted to apply down in the list every time I
> made such a mistake.

Well, the normal thing you want to do if you say "git stash" is best 
described by "Git, stash!".

However, unstash would by a nice feature. Not easy, but nice. Not easy, 
because we would be actively outsmarting the reflog machinery we use for 
the stash.

Ciao,
Dscho