commit 8e17b720943e6f2240ddf5a52e65d6e7d841d61c
parent 5cf135f9a0ac472621d133bb4a03780a7bff6640
Author: Phạm Bình An <111893501+brianhuster@users.noreply.github.com>
Date: Wed, 18 Jun 2025 20:19:00 +0700
docs: vim_diff.txt #34502
Problem:
- Missing some important Vim features
- Since Nvim 0.5, package.path and package.cpath don't include
`'runtimepath'` (thought `require()` can still find modules in
`runtimepath`)
Closes #33938
Co-authored-by: Justin M. Keyes <justinkz@gmail.com>
Diffstat:
2 files changed, 13 insertions(+), 11 deletions(-)
diff --git a/runtime/doc/lua-guide.txt b/runtime/doc/lua-guide.txt
@@ -164,7 +164,7 @@ the cache manually first:
<
------------------------------------------------------------------------------
See also:
-• |lua-module-load|
+• |lua-module-load|: how `require()` finds modules
• |pcall()|
==============================================================================
@@ -235,7 +235,6 @@ See also:
• |builtin-functions|: alphabetic list of all Vimscript functions
• |function-list|: list of all Vimscript functions grouped by topic
• |:runtime|: run all Lua scripts matching a pattern in |'runtimepath'|
-• |package.path|: list of all paths searched by `require()`
==============================================================================
Variables *lua-guide-variables*
diff --git a/runtime/doc/vim_diff.txt b/runtime/doc/vim_diff.txt
@@ -301,7 +301,7 @@ Commands:
- |:Man| is available by default, with many improvements such as completion
- |:match| can be invoked before highlight group is defined
- |:source| works with Lua
- User commands can support |:command-preview| to show results as you type
+- User commands can support |:command-preview| to show results as you type
- |:write| with "++p" flag creates parent directories.
Editor:
@@ -495,6 +495,8 @@ These Nvim features were later integrated into Vim.
- |:source| works with anonymous (no file) scripts
- 'statusline' supports unlimited alignment sections
- |vim-tutor-mode|
+- Lua: `require()` also searches for modules in 'runtimepath'.
+- Lua: vim.g, vim.w, vim.b, vim.t, vim.v, vim.fn, vim.call()
==============================================================================
Other changes *nvim-changed*
@@ -566,7 +568,6 @@ coerced to strings. See |id()| for more details, currently it uses
|CursorMoved| triggers when moving between windows.
Lua interface (|lua.txt|):
-
- `:lua print("a\0b")` will print `a^@b`, like with `:echomsg "a\nb"` . In Vim
that prints `a` and `b` on separate lines, exactly like
`:lua print("a\nb")` .
@@ -574,8 +575,6 @@ Lua interface (|lua.txt|):
E5108: Lua: [string "<Vimscript compiled string>"]:1: TEST
< whereas Vim emits only "TEST".
- Lua has direct access to Nvim |API| via `vim.api`.
-- Lua package.path and package.cpath are automatically updated according to
- 'runtimepath'. |lua-module-load|
Commands:
- |:doautocmd| does not warn about "No matching autocommands".
@@ -653,6 +652,10 @@ Options:
the default behaviour. The implementation is equivalent to setting
'titlestring' to `%t%(\ %M%)%(\ \(%{expand(\"%:~:h\")}\)%)%a\ -\ Nvim`.
+|packages|:
+- "start" packages are not explicitly reported in 'runtimepath' (though they
+ are still searched for runtime files). See |runtime-search-path|
+
==============================================================================
Missing features *nvim-missing*
@@ -713,10 +716,11 @@ Compile-time features:
- Emacs tags support
- X11 integration (see |x11-selection|)
-Cscope:
- *cscope*
-- Cscope support was removed in favour of plugin-based solutions such as:
+Editor:
+- *cscope* support was removed in favour of plugin-based solutions such as:
https://github.com/dhananjaylatkar/cscope_maps.nvim
+- *popup-window* : Use |floating-windows| instead.
+- *textprop* : Use |extmarks| instead.
Eval:
- *Vim9script* (the Vim 9+ flavor of Vimscript) is not supported.
@@ -841,7 +845,6 @@ Options:
- weirdinvert
Plugins:
-
- logiPat
- rrhelper
- *vimball*
@@ -849,9 +852,9 @@ Plugins:
- tools/check_colors.vim
- macros/{justify,matchit,shellmenu,swapmous}.vim: use `packadd! justify` etc.
directly
+- HelpToc: Use |gO| instead.
Providers:
-
- *if_lua* : Nvim |Lua| API is not compatible with Vim's "if_lua".
- *if_mzscheme*
- |if_pyth|: *python-bindeval* *python-Function* are not supported.
