aboutsummaryrefslogtreecommitdiff
path: root/scripts/gen_vimdoc.py
Commit message (Collapse)AuthorAge
...
* doc: fix scripts and regenerate (#12506)TJ DeVries2020-07-02
| | | | | | | | | | | | | | | | | * Fix some small doc issues * doc: fixup * doc: fixup * Fix lint and rebase * Remove bad advice * Ugh, stupid mpack files... * Don't let people include these for now until they specifically want to * Prevent duplicate tag
* doc [ci skip] #11656Justin M. Keyes2020-01-12
|
* gen_vimdoc.py: rename `mode` to `target`Justin M. Keyes2019-12-31
|
* gen_vimdoc.py: generate LSP docsJustin M. Keyes2019-12-31
|
* gen_vimdoc.py: sort by nameJustin M. Keyes2019-12-30
|
* gen_vimdoc.py: better handling of inline (non-block) nodesJustin M. Keyes2019-12-30
|
* gen_vimdoc.py: fix deprecated checkJustin M. Keyes2019-12-30
|
* gen_vimdoc.py: lint #11593Daniel Hahler2019-12-23
|
* Merge #11396 'gen_vimdoc.py: mpack result' [ci skip]Justin M. Keyes2019-12-22
|\
| * gen_vimdoc.py: rename for clarityJustin M. Keyes2019-12-21
| | | | | | | | | | - render_para => fmt_node_as_vimhelp - Inline parse_parblock() in fmt_node_as_vimhelp()
| * gen_vimdoc.py: mpack: collect functions in 1 dictJustin M. Keyes2019-12-21
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | All Nvim API, core Vimscript, and core Lua functions are globally unique, so there is no need for per-module nested dicts. BEFORE (generated mpack structure): [ { "buffer.c": { "nvim__buf_stats": { ... }, ... }, "window.c": { "nvim_win_close": { ... }, ... }, ... } ] AFTER (generated mpack structure): [ { "nvim__buf_stats": { ... }, "nvim_buf_attach": { ... }, "nvim_tabpage_set_var": { ... }, "nvim_ui_attach": { ... }, "nvim_win_close": { ... } } ]
| * gen_vimdoc.py: fix "seealso", "xrefs"Justin M. Keyes2019-12-21
| | | | | | | | | | | | - Also fix xrefs ("Deprecated" section) - Fix "Deprecated" rendering by a weird hack (see comment). - Eliminate unnecessary use of render_para()
| * gen_vimdoc.py: mpack: exclude deprecated functionsJustin M. Keyes2019-12-21
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The `mpack` variable was a tuple, which manifests as an array in the generated msgpack structure. - Removes noise from the mpack data (deprecated functions are deprecated). - Eliminates 1 level of nesting. BEFORE: [ { "buffer.c": [ { "nvim__buf_stats": { ... }, ... }, { "buffer_del_line": { ... }, ... }, ], ... } ] AFTER: [ { "buffer.c": { "nvim__buf_stats": { ... }, ... }, ... ]
| * gen_vimdoc.py: fix mpack generatorJustin M. Keyes2019-12-21
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | - make parameters_doc a dict intead of a list BEFORE: "parameters_doc": [ { "buffer": "Buffer handle, or 0 for current buffer" } ], AFTER: "parameters_doc": { "buffer": "Buffer handle, or 0 for current buffer" }, - make "return", "seealso", lists instead of strings
| * gen_vimdoc.py: DRYJustin M. Keyes2019-12-21
| |
| * [scripts/gen_vimdoc.py] Generate better-formatted mpacksmolck2019-11-15
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Changes the generated msgpack result values in the runtime/doc/*.mpack files to be formatted like this (instead of being formatted like Vim help text): [ 'nvim_win_get_var': { 'signature': 'nvim_win_get_var({window}, {name}, {err})', 'parameters': [('Window', 'window'), ('String', 'name'), ('Error *', 'err')], 'parameters_doc': [{'window': 'Window handle, or 0 for current window', 'name': 'Variable name'}], 'doc': ['Gets a window-scoped (w:) variable'], 'return': ['Variable value'], 'seealso': [] } }, ... ]
* | doc: Lua [ci skip] #11378Justin M. Keyes2019-11-17
|/ | | | - Rework :help lua-commands - Rename if_lua.txt => lua.txt
* lintJustin M. Keyes2019-10-26
|
* gen_vimdoc.py: dump API docs to msgpack #11296smolck2019-10-26
| | | | | | | | | | | | | | | | | | | | | | | Convenient for API clients who want to reuse the API docs in their own docs. Could be used e.g. to eliminate nvim.net's own doxygen parser: https://github.com/neovim/nvim.net/tree/3a736232a4e7b7a2a1eff4bded24d2bf27a918c2/src/NvimClient.APIGenerator/Docs TODO: currently the result values are formatted as Vim help docs. We should change the values to have structure, something like this: [{ 'nvim_win_get_var': [ 'line1, 'line2', [ 'item1', 'item2', ... ] ], 'nvim_win_set_var': [ ... ], ... }] close #11296
* doc: |api-fast| [ci skip]Justin M. Keyes2019-09-09
|
* py: flake8 fixesDaniel Hahler2019-07-29
|
* scripts: autopep8Daniel Hahler2019-07-29
|
* doc #10017Justin M. Keyes2019-05-25
| | | | | - gen_vimdoc.py: fancy "bullet" - rework `:help channel-callback` - rename `:help buffered` to `:help channel-buffered`
* gen_vimdoc.py: support lua/shared.lua module [ci skip]Justin M. Keyes2019-05-19
|
* gen_vimdoc.py: get Lua docs via lua2dox.lua #9740KillTheMule2019-05-18
|
* gen_vimdoc.py: support <pre> preformatted text [ci skip]Justin M. Keyes2019-05-01
|
* gen_vimdoc.py: skip "Parameters" header if all excludedJustin M. Keyes2019-04-22
|
* gen_vimdoc.py: render nested lists, etc [ci skip]Justin M. Keyes2019-03-26
- render_node() is now the main rendering function: it traverses a node and builds the Vim help text recursively. - render_para() is weird and ugly, it is the entry-point for rendering the help text for one docstring'd function.