averello/macvim-mirror
1
0
Fork 0
mirror of https://github.com/macvim-dev/macvim.git synced 2026-06-11 15:37:29 +02:00
Code Issues Packages Projects Releases Wiki Activity

runtime(doc): clarify vim.eval behavior with Vim special variables

Browse Source 
Problem:  The behavior of vim.eval() with Vim special variables is not
          clearly documented. It is (partly) the reason why Nvim
          Python's vim.eval gives different output when evaluating
          v:true and v:false
Solution: Document it (Phạm Bình An)

closes: #19157

Signed-off-by: Phạm Bình An <phambinhanctb2004@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
This commit is contained in:
Phạm Bình An
2026-01-11 18:19:52 +00:00
committed by Christian Brabandt
parent 69075d35be
commit 1e54023673
1 changed files with 6 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files
runtime/doc/if_pyth.txt
+6 -4
View File
@@ -1,4 +1,4 @@
*if_pyth.txt* For Vim version 9.1. Last change: 2025 Nov 09
*if_pyth.txt* For Vim version 9.1. Last change: 2026 Jan 11
VIM REFERENCE MANUAL by Paul Moore
@@ -183,9 +183,11 @@ vim.eval(str) *python-eval*
Evaluates the expression str using the vim internal expression
evaluator (see |expression|). Returns the expression result as:
- a string if the Vim expression evaluates to a string or number
- a list if the Vim expression evaluates to a Vim list
- a tuple if the Vim expression evaluates to a Vim tuple
- a dictionary if the Vim expression evaluates to a Vim dictionary
- a list if the Vim expression evaluates to a Vim |list|
- a tuple if the Vim expression evaluates to a Vim |tuple|
- a dictionary if the Vim expression evaluates to a Vim |dict|
- a boolean if Vim exression evaluates to |v:true| or |v:false|
- `None` if Vim expression evaluates to |v:null| or |v:none|
Dictionaries, lists and tuples are recursively expanded.
Examples: >
:" value of the 'textwidth' option