Mercurial > vim
diff runtime/doc/eval.txt @ 19033:f0312cf3c792 v8.2.0077
patch 8.2.0077: settagstack() cannot truncate at current index
Commit: https://github.com/vim/vim/commit/271fa08a35b8d320d3a40db4ddae83b698fdd4fb
Author: Bram Moolenaar <Bram@vim.org>
Date: Thu Jan 2 14:02:16 2020 +0100
patch 8.2.0077: settagstack() cannot truncate at current index
Problem: settagstack() cannot truncate at current index.
Solution: Add the "t" action. (Yegappan Lakshmanan, closes https://github.com/vim/vim/issues/5417)
| author | Bram Moolenaar <Bram@vim.org> |
|---|---|
| date | Thu, 02 Jan 2020 14:15:05 +0100 |
| parents | e378907d79bf |
| children | d20ed2e5a776 |
line wrap: on
line diff
--- a/runtime/doc/eval.txt +++ b/runtime/doc/eval.txt @@ -8774,11 +8774,21 @@ settagstack({nr}, {dict} [, {action}]) {nr} can be the window number or the |window-ID|. For a list of supported items in {dict}, refer to - |gettagstack()| + |gettagstack()|. "curidx" takes effect before changing the tag + stack. *E962* - If {action} is not present or is set to 'r', then the tag - stack is replaced. If {action} is set to 'a', then new entries - from {dict} are pushed onto the tag stack. + How the tag stack is modified depends on the {action} + argument: + - If {action} is not present or is set to 'r', then the tag + stack is replaced. + - If {action} is set to 'a', then new entries from {dict} are + pushed (added) onto the tag stack. + - If {action} is set to 't', then all the entries from the + current entry in the tag stack or "curidx" in {dict} are + removed and then new entries are pushed to the stack. + + The current index is set to one after the length of the tag + stack after the modification. Returns zero for success, -1 for failure.