The next iteration will amend the synopsis as follows: -'git stash' show [<stash>] -'git stash' drop [-q|--quiet] [<stash>] -'git stash' ( pop | apply ) [--index] [-q|--quiet] [<stash>] -'git stash' branch <branchname> [<stash>] +'git stash' show [<stash-like>] +'git stash' drop [-q|--quiet] [<stash-entry>] +'git stash' pop [--index] [-q|--quiet] [<stash-entry>] +'git stash' apply [--index] [-q|--quiet] [<stash-like>] +'git stash' branch <branchname> [<stash-like>] with corresponding changes to the body. This will help clarify when a stash entry is required and when a stash-like commit can be used instead. On Sun, Aug 8, 2010 at 2:46 PM, Jon Seymour <jon.seymour@xxxxxxxxx> wrote: > Update the documentation to indicate that git stash branch only attempts > to drop the specified stash if it looks like stash reference. > > Signed-off-by: Jon Seymour <jon.seymour@xxxxxxxxx> > --- > Documentation/git-stash.txt | 4 ++-- > 1 files changed, 2 insertions(+), 2 deletions(-) > > diff --git a/Documentation/git-stash.txt b/Documentation/git-stash.txt > index 473889a..c7b7e4e 100644 > --- a/Documentation/git-stash.txt > +++ b/Documentation/git-stash.txt > @@ -115,8 +115,8 @@ branch <branchname> [<stash>]:: > Creates and checks out a new branch named `<branchname>` starting from > the commit at which the `<stash>` was originally created, applies the > changes recorded in `<stash>` to the new working tree and index, then > - drops the `<stash>` if that completes successfully. When no `<stash>` > - is given, applies the latest one. > + drops the `<stash>` if that completes successfully and `<stash>` looks like a > + stash the name of a stash list entry. When no `<stash>` is given, applies the latest one. > + > This is useful if the branch on which you ran `git stash save` has > changed enough that `git stash apply` fails due to conflicts. Since > -- > 1.7.2.1.51.g82c0c0 > > -- 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