# [PATCH] Doc: reference the "stash list" in autostash docs 4 messages from 2020-05-05 to 2020-05-06. Participants: Denton Liu, Junio C Hamano. Thread: https://gitlist.dev/t/53401 ## Denton Liu, 2020-05-05 13:00 Subject: [PATCH] Doc: reference the "stash list" in autostash docs Message-ID: <0b898ca26b0399e9f14b9170f6586014dee80cf5.1588683624.git.liu.denton@gmail.com> URL: https://gitlist.dev/e/0b898ca26b0399e9f14b9170f6586014dee80cf5.1588683624.git.liu.denton%40gmail.com ``` In documentation pertaining to autostash behavior, we refer to the "stash reflog". This description is too low-level as the reflog refers to an implementation detail of how the stash works and, for end-users, they do not need to be aware of this at all. Change references of "stash reflog" to "stash list", which should be provide more accessible terminology for end-users. Signed-off-by: Denton Liu --- Notes: This patch is based on 'dl/merge-autostash-rebase-quit-fix'. Documentation/git-merge.txt | 4 ++-- Documentation/git-rebase.txt | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/Documentation/git-merge.txt b/Documentation/git-merge.txt index ec06b2f8c2..3819fadac1 100644 --- a/Documentation/git-merge.txt +++ b/Documentation/git-merge.txt @@ -106,12 +106,12 @@ commit or stash your changes before running 'git merge'. `MERGE_HEAD` is present unless `MERGE_AUTOSTASH` is also present in which case 'git merge --abort' applies the stash entry to the worktree whereas 'git reset --merge' will save the stashed changes in the stash -reflog. +list. --quit:: Forget about the current merge in progress. Leave the index and the working tree as-is. If `MERGE_AUTOSTASH` is present, the - stash entry will be saved to the stash reflog. + stash entry will be saved to the stash list. --continue:: After a 'git merge' stops due to conflicts you can conclude the diff --git a/Documentation/git-rebase.txt b/Documentation/git-rebase.txt index 7d0c89a184..fa969d8064 100644 --- a/Documentation/git-rebase.txt +++ b/Documentation/git-rebase.txt @@ -257,7 +257,7 @@ See also INCOMPATIBLE OPTIONS below. Abort the rebase operation but HEAD is not reset back to the original branch. The index and working tree are also left unchanged as a result. If a temporary stash entry was created - using --autostash, it will be saved to the stash reflog. + using --autostash, it will be saved to the stash list. --apply: Use applying strategies to rebase (calling `git-am` -- 2.26.2.548.gbb00c8a0a9 ``` ## Junio C Hamano, 2020-05-05 18:36 Subject: Re: [PATCH] Doc: reference the "stash list" in autostash docs Message-ID: URL: https://gitlist.dev/e/xmqq8si6b55l.fsf%40gitster.c.googlers.com In-Reply-To: <0b898ca26b0399e9f14b9170f6586014dee80cf5.1588683624.git.liu.denton@gmail.com> ``` Denton Liu writes: > In documentation pertaining to autostash behavior, we refer to the > "stash reflog". This description is too low-level as the reflog refers > to an implementation detail of how the stash works and, for end-users, > they do not need to be aware of this at all. > > Change references of "stash reflog" to "stash list", which should be > provide more accessible terminology for end-users. Sounds like a good thing to do. > > Signed-off-by: Denton Liu > --- > > Notes: > This patch is based on 'dl/merge-autostash-rebase-quit-fix'. Thanks. This kind of note is very much appreciated. > Documentation/git-merge.txt | 4 ++-- > Documentation/git-rebase.txt | 2 +- > 2 files changed, 3 insertions(+), 3 deletions(-) > > diff --git a/Documentation/git-merge.txt b/Documentation/git-merge.txt > index ec06b2f8c2..3819fadac1 100644 > --- a/Documentation/git-merge.txt > +++ b/Documentation/git-merge.txt > @@ -106,12 +106,12 @@ commit or stash your changes before running 'git merge'. > `MERGE_HEAD` is present unless `MERGE_AUTOSTASH` is also present in > which case 'git merge --abort' applies the stash entry to the worktree > whereas 'git reset --merge' will save the stashed changes in the stash > -reflog. > +list. > > --quit:: > Forget about the current merge in progress. Leave the index > and the working tree as-is. If `MERGE_AUTOSTASH` is present, the > - stash entry will be saved to the stash reflog. > + stash entry will be saved to the stash list. > > --continue:: > After a 'git merge' stops due to conflicts you can conclude the > diff --git a/Documentation/git-rebase.txt b/Documentation/git-rebase.txt > index 7d0c89a184..fa969d8064 100644 > --- a/Documentation/git-rebase.txt > +++ b/Documentation/git-rebase.txt > @@ -257,7 +257,7 @@ See also INCOMPATIBLE OPTIONS below. > Abort the rebase operation but HEAD is not reset back to the > original branch. The index and working tree are also left > unchanged as a result. If a temporary stash entry was created > - using --autostash, it will be saved to the stash reflog. > + using --autostash, it will be saved to the stash list. > > --apply: > Use applying strategies to rebase (calling `git-am` ``` ## Denton Liu, 2020-05-05 22:59 Subject: Re: [PATCH] Doc: reference the "stash list" in autostash docs Message-ID: <20200505225901.GA1454@generichostname> URL: https://gitlist.dev/e/20200505225901.GA1454%40generichostname In-Reply-To: ``` Hi Junio, Sorry, I noticed a typo when reading this patch over. On Tue, May 05, 2020 at 11:36:22AM -0700, Junio C Hamano wrote: > Denton Liu writes: > > > In documentation pertaining to autostash behavior, we refer to the > > "stash reflog". This description is too low-level as the reflog refers > > to an implementation detail of how the stash works and, for end-users, > > they do not need to be aware of this at all. > > > > Change references of "stash reflog" to "stash list", which should be s/ be$// > > provide more accessible terminology for end-users. Thanks, Denton ``` ## Junio C Hamano, 2020-05-06 03:57 Subject: Re: [PATCH] Doc: reference the "stash list" in autostash docs Message-ID: URL: https://gitlist.dev/e/xmqqmu6l90m3.fsf%40gitster.c.googlers.com In-Reply-To: <20200505225901.GA1454@generichostname> ``` Denton Liu writes: > Hi Junio, > > Sorry, I noticed a typo when reading this patch over. > > On Tue, May 05, 2020 at 11:36:22AM -0700, Junio C Hamano wrote: >> Denton Liu writes: >> >> > In documentation pertaining to autostash behavior, we refer to the >> > "stash reflog". This description is too low-level as the reflog refers >> > to an implementation detail of how the stash works and, for end-users, >> > they do not need to be aware of this at all. >> > >> > Change references of "stash reflog" to "stash list", which should be > > s/ be$// Amended. ```