aboutsummaryrefslogtreecommitdiff
path: root/runtime/doc/plugins.txt
Commit message (Collapse)AuthorAge
* docs(help): specify h4 "function signature" format #42434masterJustin M. Keyes2 days
| | | | | | | | | | | | | | | | | | | | | Work towards enabling ["flow" layout](https://github.com/neovim/neovim/blob/9244da12e400ec0291450a5e9400d995e7a29b83/src/gen/gen_help_html.lua#L86-L88) in all `:help` files. Problem: The final boss of vimdoc pseudo-structure: Vim's quasi-headings on function signatures and excmd docs is visually distinctive but too inconsistent for a nice parse rule. Solution: - Define the quasi-heading format as an "h4" variant, specified at `:help help-tag-heading`. - For simplicity and predictability, it is defined as any line that ends with a help tag(s) preceded by 2 or more spaces (or 1 tab). - Update existing docs. - This one-time update has a lot of changes, but is very unlikely to conflict with ported Vim-patches because (1) Vim rarely adds new *excmds* that we want, and (2) *function* docs are auto-generated. ref https://github.com/neovim/tree-sitter-vimdoc/issues/110
* fix(lua): enable param-type-mismatch diagnosticLewis Russell2026-09-28
| | | | | | | | | Problem: Argument type mismatches are excluded from EmmyLua checks. Solution: Correct runtime annotations and calls, document local checker workarounds, and enable the diagnostic. AI-assisted
* fix(editorconfig): handle root separately from propertiesLewis Russell2026-09-28
| | | | | | | | | Problem: A child root=false masks a parent root=true during merging. Solution: Return the search boundary separately from string properties. Exclude root from property callbacks and b:editorconfig. AI-assisted
* feat(dir): open entries in splits with a, o mappings #41834Barrett Ruth2026-09-11
|
* docs: misc #41452Justin M. Keyes2026-08-23
| | | | | Co-authored-by: darkdi <rantovov5@gmail.com> Co-authored-by: Qiaoxi Guo <28090444+breadtitor@users.noreply.github.com> Co-authored-by: zaveshaa <zaveshaa@gmail.com>
* docs(dir): how to decorate a listing #41315Barrett Ruth2026-08-23
|
* docs: misc, cwd, vimscript.txt #41356Justin M. Keyes2026-08-17
| | | Extract vimscript.txt from repeat.txt
* feat(dir): user can sort/filter listings, DirReadPost event #41138Barrett Ruth2026-08-14
| | | | | | | | | | | | Problem: Directory listing entries cannot be customized (filtered, reordered). Listings are read by a BufReadCmd, which suppresses BufReadPost, so they are the only buffers with no post-read event to hook. Solution: Introduce a post-render User autocmd `DirReadPost`, marking the dir buffer writable for the duration and before the cursor is placed, so handlers can sort or filter it with ordinary commands. Document common recipes
* refactor(defaults): edit global cwd on "1-" #41254Nathan Zeng2026-08-11
| | | | | | | | | Problem: `1-` does nothing from a directory buffer, because we are already in the buffer-local CWD. It's also unintuitive that this mapping behaves differently based on the resolved CWD. Solution: Have `1-` open the global CWD.
* docs: misc, :bcd, slug()Justin M. Keyes2026-08-06
|
* feat(dir): set buffer-local CWD #41174Barrett Ruth2026-08-06
|
* fix(dir): preserve alternate file #41177Barrett Ruth2026-08-05
|
* refactor(zip)!: builtin zip.lua plugin #40846Barrett Ruth2026-07-29
| | | | | | | | | | Problem: The bundled `zip` plugin is implemented in Vimscript, making it harder to maintain and build on with Nvim's Lua runtime infrastructure. Solution: Add an opt-out `zip.lua` browser backed by `nvim.dir`, and disable the legacy Vimscript implementation by moving it to `pack/dist/opt/zip/`. Load it with `:packadd zip`.
* docs(dir): buffer state discarded by 'bufhidden' #41014Barrett Ruth2026-07-28
|
* feat(dir): open cwd with `1-` #40948Barrett Ruth2026-07-27
|
* docs: misc, remove some old help tags #40214Justin M. Keyes2026-07-18
| | | | | | | | | | - Remove old help tags: they add noise to cmdline completion. Co-authored-by: acehinnnqru <acehinnnqru@gmail.com> Co-authored-by: KangaZero <samuelyongw@gmail.com> Co-authored-by: Simone Ragusa <hi@interrato.dev> Co-authored-by: Chinmay Dalal <~chinmay/public-inbox@lists.sr.ht> Co-authored-by: coyaSONG <66289470+coyaSONG@users.noreply.github.com> Co-authored-by: Olivia Kinnear <git@superatomic.dev>
* fix(dir): custom 3P directory-browser #40725Barrett Ruth2026-07-16
| | | | | | | | | | Problem: Third-party directory browsers do not have a documented way to take over local directory buffers from nvim.dir. Solution: Document deleting the nvim.dir augroup and handling FileType directory as the after-startup handoff, and avoid installing the built-in buffer-local "-" mapping when "-" is already mapped.
* docs(dir): remove augroup deletion note #40696Barrett Ruth2026-07-11
|
* fix(dir): restore loaded plugin guard #40528Barrett Ruth2026-07-01
|
* fix(dir): use `nvim.dir` augroup #40507Barrett Ruth2026-06-30
|
* fix(dir): remove loaded plugin guard #40489Barrett Ruth2026-06-30
|
* refactor: cleanup, docs #40480Justin M. Keyes2026-06-29
|
* fix(dir): respect directory buffer lifetime #40453Barrett Ruth2026-06-27
| | | | | | | | | | Problem: dir.lua leaves previously-navigated directory buffers around. This is fine by default, but users need a simple way to opt out. Solution: 1. Respect `set hidden` (via `'bufhidden'`) as one way to make previously-navigated dir buffers from showing up. 2. Document a one-liner to hide these buffers
* feat(dir.lua): global "-" default mapping #40426Barrett Ruth2026-06-26
|
* feat(runtime): replace netrw with a very small script #39723Barrett Ruth2026-06-25
| | | | | | | | | | | | | | Problem: `:edit <dir>` and `nvim <dir>` currently rely on netrw to show local directory contents. Solution: - Provide `filetype=directory`. - Introduce dir.lua, a small plugin that provides directory listing, opening items, parent navigation, and refresh. - `netrw` remains available for `:Explore`, remote paths, archives, and file operations. To continue Co-authored-by: Justin M. Keyes <justinkz@gmail.com>
* refactor(docs): generate tui.txt $NVIM_TERMDEFS keys #39836Kyle2026-05-21
| | | | | | | | | Problem: Potential documentation drift in `tui.txt` if fields for `$NVIM_TERMDEFS` change. Solution: Generate docs for `tui.txt`. Add `brief_xform` to `gen_vimdoc.lua` to allow transforming briefs during generation.
* fix(lua): fields of `nvim.spellfile.Opts` are optional #39902Olivia Kinnear2026-05-20
|
* docs: sort quasi-keysetsJustin M. Keyes2026-04-26
|
* docs: miscJustin M. Keyes2026-04-12
| | | | | | | | Close #38748 Close #38866 Co-authored-by: Mario Loriedo <mario.loriedo@gmail.com> Co-authored-by: Anakin Childerhose <anakin@childerhose.ca>
* docs: api, plugins, ui2Justin M. Keyes2026-03-24
|
* fix(runtime)!: move "tohtml" to pack/dist/opt/ #34557Justin M. Keyes2026-03-23
| | | | | | | | | | | Problem: The "tohtml" plugin is loaded by default. Solution: - Move it to `pack/dist/opt/nvim.tohtml/`, it is an "opt-in" plugin now. - Document guidelines. - Also revert the `plugin/` locations of `spellfile.lua` and `net.lua`. That idea was not worth the trouble, it will be too much re-education for too little gain.
* feat(difftool): replace old "nvim -d" automatically #38057Tomas Slusny2026-02-28
| | | | | | | | | | Problem: "nvim -d" doesn't leverage nvim.difftool. Solution: If nvim.difftool was enabled via :packadd, automatically handle "nvim -d" on startup. nvim -c "packadd nvim.difftool" -d dir1/ dir2/
* docs: misc, editorconfigJustin M. Keyes2025-12-15
| | | | fix https://github.com/neovim/neovim/issues/36858
* feat(spell): opt-out of confirm when downloading spellfiles #36836Olivia Kinnear2025-12-06
|
* docs: miscJustin M. Keyes2025-11-23
| | | | | | | | | | Close #36441 Close #36631 Close #36656 Co-authored-by: Maria José Solano <majosolano99@gmail.com> Co-authored-by: glepnir <glephunter@gmail.com> Co-authored-by: "Mike J. McGuirk" <mike.j.mcguirk@gmail.com>
* docs(undotree): rename help tag #36497Yochem van Rosmalen2025-11-12
| | | | | | | Problem: confusing that there is the tag `undo-tree` (the Vim implementation) and `undotree` (the Lua plugin for visualization). Solution: rename tag to undotree-plugin. Mention the plugin in the docs of |undotree|.
* refactor(spellfile): config() interface, docs #36481Yochem van Rosmalen2025-11-09
| | | | | | | | | | | | Problem: - Exposing the raw config as table is a pattern not seen anywhere else in the Nvim codebase. - Old spellfile.vim docs still available, no new documentation Solution: - Exposing a `config()` function that both acts as "getter" and "setter" is a much more common idiom (e.g. vim.lsp, vim.diagnostic). - Add new documentation and link old docs to |spellfile.lua| instead of |spellfile.vim|.
* fix(build): gen_help_html fails #36359Justin M. Keyes2025-10-27
| | | | | | | | | | | | | | | | | | | | | Problem: fe4faaf81a6f3 added an invalid "redirect" item, which caused the assert() to fail, which then caused the neovim/doc/ CI to fail: https://github.com/neovim/doc/actions/runs/18830779387/job/53721736276 : The previous commit e69beb9b1aba tried to fix a different issue, which has gone hidden because the "invalid tags" failure has been present on the neovim/doc/ but was silently failing. invalid tags: { ["g:netrw_keepdir"] = "usr_22.txt", netrw = "vi_diff.txt", ... plugins = "editorconfig" } Solution: - Fix the invalid redirect. - Improve the redirects assertion.
* fix(difftool): ensure split layout, use systemlist #36145Tomas Slusny2025-10-12
| | | | | | | | | | - Always open the right window to the right, regardless of 'splitright' setting, ensuring the left window is always leftmost. - Use `vim.fn.systemlist` for diffr output to avoid manual splitting. - Add a test to verify window layout consistency with 'splitright' and 'nosplitright' options. - Escape quotes in git difftool example properly. Signed-off-by: Tomas Slusny <slusnucky@gmail.com>
* feat(plugins): nvim.difftool can compare directories #35448Tomas Slusny2025-10-11
| | | | | | | | | | | | | | | | | | | | | | | | | | | Problem: Built-in diff mode (nvim -d) does not support directory diffing as required by git difftool -d. This makes it difficult to compare entire directories, detect renames, and navigate changes efficiently. Solution: Add a DiffTool plugin and command that enables side-by-side diffing of files and directories in Neovim. The plugin supports rename detection, highlights changes in the quickfix list, and provides a user command for easy invocation. This allows proper integration with git difftool -d for directory comparison. Example git config: ```ini [diff] tool = nvim_difftool [difftool "nvim_difftool"] cmd = nvim -c "packadd nvim.difftool" -c "DiffTool $LOCAL $REMOTE" ``` Signed-off-by: Tomas Slusny <slusnucky@gmail.com> Co-authored-by: Phạm Bình An <111893501+brianhuster@users.noreply.github.com> Co-authored-by: Justin M. Keyes <justinkz@gmail.com>
* fix(undotree): mark title field annotation as optional (#36102)Mike J McGuirk2025-10-09
| | | | | * fix(undotree): mark title field annotation as optional * fix(doc): run make doc for undotree annotation change
* feat(runtime): undotree #35627altermo2025-10-07
| | | | | | | Problem No builtin way to visualize and navigate the undo-tree. Solution Include an "opt" plugin.
* docs: standard-plugin-list #35796Yochem van Rosmalen2025-09-17
| | | | | | | The following plugins are intentionally left out: • osc52.lua: not user-facing • rplugin.vim: will be removed • shellmenu: will probably be removed
* docs: move editorconfig.txt into plugins.txtJustin M. Keyes2025-09-13
| | | | | | | | | | | It helps to have plugins living in one common area, because it signals to users the mechanisms for controlling them, which are typically driven by keymaps and autocmds rather than builtin options. We can always revisit if plugins.txt gets "too big" (for example, we may want to introduce "project.txt" for the project concept, where editorconfig and 'exrc' are relevant), but for now it's rather unusual for editorconfig.txt to have its own dedicated helpfile.
* docs: plugins.txt #35680altermo2025-09-10
Co-authored-by: Justin M. Keyes <justinkz@gmail.com>