Re: [PATCH] Document git-stash

From: Johannes Schindelin <johannes.schindelin@gmx.de>
Date: Jul 1, 2007, 22:57 UTC
Message-ID: <Pine.LNX.4.64.0707012355150.4438@racer.site>
In-Reply-To: <7vlkdz4wp3.fsf@assigned-by-dhcp.cox.net>

Hi,

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

Show 18 quoted lines

> 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