aboutsummaryrefslogtreecommitdiff
path: root/runtime
diff options
context:
space:
mode:
authorJustin M. Keyes <justinkz@gmail.com>2017-07-28 02:31:03 +0200
committerJustin M. Keyes <justinkz@gmail.com>2017-07-28 02:34:24 +0200
commit3b45f676c0f07aa2826f191f555ba0d5f53e6d7c (patch)
tree6d60711a6db394f3f2648a5d0049f3f7260e1a94 /runtime
parentdc685387a3d60e9ea3d09c80c74d4613b618cf14 (diff)
downloadrneovim-3b45f676c0f07aa2826f191f555ba0d5f53e6d7c.tar.gz
rneovim-3b45f676c0f07aa2826f191f555ba0d5f53e6d7c.tar.bz2
rneovim-3b45f676c0f07aa2826f191f555ba0d5f53e6d7c.zip
menu_get(): doc
Diffstat (limited to 'runtime')
-rw-r--r--runtime/doc/eval.txt65
-rw-r--r--runtime/doc/vim_diff.txt1
2 files changed, 36 insertions, 30 deletions
diff --git a/runtime/doc/eval.txt b/runtime/doc/eval.txt
index 3a27b2d7a0..b68c70bf9f 100644
--- a/runtime/doc/eval.txt
+++ b/runtime/doc/eval.txt
@@ -5509,43 +5509,48 @@ max({expr}) Return the maximum value of all items in {expr}.
an error. An empty |List| or |Dictionary| results in zero.
menu_get({path}, {modes}) *menu_get()*
- Returns a |Dictionary| with all the submenu of {path} (set to
- an empty string to match all menus). Only the commands matching {modes} are
- returned ('a' for all, 'i' for insert see |creating-menus|).
+ Returns a |List| of |Dictionaries| describing |menus| (defined
+ by |:menu|, |:amenu|, etc.).
+ {path} limits the result to a subtree of the menu hierarchy
+ (empty string matches all menus). E.g. to get items in the
+ "File" menu subtree: >
+ :echo menu_get('File','')
+<
+ {modes} is a string of zero or more modes (see |maparg()| or
+ |creating-menus| for the list of modes). "a" means "all".
- For instance, executing:
->
+ For example: >
nnoremenu &Test.Test inormal
inoremenu Test.Test insert
vnoremenu Test.Test x
echo menu_get("")
<
-should produce an output with a similar structure:
+ returns something like this:
>
- [ {
- "hidden": 0,
- "name": "Test",
- "priority": 500,
- "shortcut": 84,
- "submenus": [ {
- "hidden": 0,
- "mappings": {
- i": {
- "enabled": 1,
- "noremap": 1,
- "rhs": "insert",
- "sid": 1,
- "silent": 0
- },
- n": { ... },
- s": { ... },
- v": { ... }
- },
- "name": "Test",
- "priority": 500,
- "shortcut": 0
- } ]
- } ]
+ [ {
+ "hidden": 0,
+ "name": "Test",
+ "priority": 500,
+ "shortcut": 84,
+ "submenus": [ {
+ "hidden": 0,
+ "mappings": {
+ i": {
+ "enabled": 1,
+ "noremap": 1,
+ "rhs": "insert",
+ "sid": 1,
+ "silent": 0
+ },
+ n": { ... },
+ s": { ... },
+ v": { ... }
+ },
+ "name": "Test",
+ "priority": 500,
+ "shortcut": 0
+ } ]
+ } ]
<
*min()*
diff --git a/runtime/doc/vim_diff.txt b/runtime/doc/vim_diff.txt
index 5801da1132..270e958609 100644
--- a/runtime/doc/vim_diff.txt
+++ b/runtime/doc/vim_diff.txt
@@ -127,6 +127,7 @@ Functions:
|dictwatcheradd()| notifies a callback whenever a |Dict| is modified
|dictwatcherdel()|
|execute()| works with |:redir|
+ |menu_get()|
|msgpackdump()|, |msgpackparse()| provide msgpack de/serialization
Events: