Skip to content

Commit 85f52c6

Browse files
docs: Auto-generate user / API documentation + vimtags
1 parent e7e12a3 commit 85f52c6

3 files changed

Lines changed: 42 additions & 22 deletions

File tree

doc/lua-console.nvim.txt

Lines changed: 28 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -39,32 +39,44 @@ the whole thing again, copying the paths from error stacktraces and so on. I
3939
needed something better, so there it is.
4040

4141

42+
43+
4244
✨ FEATURES*lua-console.nvim-💻-lua-console-main-develop-luarocks-✨-features*
4345

4446
- Evaluate single line expressions and statements, visually selected lines of code or the whole buffer
45-
- Pretty print Lua objects, including function details and their source paths
46-
- Show normal and error output in the console/buffer, including output of `print()`, errors and stacktraces.
47+
- Pretty print Lua objects, including results of assignments, function details and their source paths
48+
- Show normal and error output inline in the console/buffer, including output of `print()`, errors and stacktraces.
4749
- Syntax highlighting and autocompletion
48-
- Load Neovim’s messages into console for inspection and copy/paste
50+
- Load Neovim’s messages and output of ex commands into console for inspection and copy/paste
4951
- Open links from stacktraces and function sources
5052
- Save / Load / Autosave console session
5153
- Use as a scratch pad for code gists
5254
- Attach code evaluators to any buffer
5355

5456

57+
58+
5559
📦 INSTALLATION*lua-console.nvim-💻-lua-console-main-develop-luarocks-📦-installation*
5660

5761
With lazy.nvim <https://github.com/folke/lazy.nvim>:
5862

5963
>lua
6064
return {
6165
"yarospace/lua-console.nvim",
62-
lazy = true, keys = "`", opts = {},
66+
lazy = true,
67+
keys = {'`', '<Leader>`'},
68+
opts = {},
6369
}
6470
<
6571

66-
otherwise, install with your favorite package manager and add
67-
`require('lua-console').setup { custom_options }` somewhere in your config.
72+
otherwise, install with your favorite package manager and add somewhere in your
73+
config:
74+
75+
>lua
76+
require('lua-console').setup { your_custom_options }
77+
<
78+
79+
6880

6981

7082
⚙️ CONFIGURATION*lua-console.nvim-💻-lua-console-main-develop-luarocks-⚙️-configuration*
@@ -111,6 +123,8 @@ Default Settings ~
111123
<
112124

113125

126+
127+
114128
🚀 BASIC USAGE (WITH DEFAULT MAPPINGS)*lua-console.nvim-💻-lua-console-main-develop-luarocks-🚀-basic-usage-(with-default-mappings)*
115129

116130
- Install, press the mapped key ``` and start exploring.
@@ -135,6 +149,8 @@ Default Settings ~
135149
- You can resize the console with `<C-Up>` and `<C-Down>`.
136150

137151

152+
153+
138154
📓 NOTES ON GLOBALS, LOCALS AND PRESERVING EXECUTION CONTEXT*lua-console.nvim-💻-lua-console-main-develop-luarocks-📓-notes-on-globals,-locals-and-preserving-execution-context*
139155

140156

@@ -160,6 +176,8 @@ There are two functions available within the console:
160176
- `_ctx_clear()` - clears the context
161177

162178

179+
180+
163181
⭐ EXTRA FEATURES*lua-console.nvim-💻-lua-console-main-develop-luarocks-⭐-extra-features*
164182

165183

@@ -276,6 +294,8 @@ SETTING UP
276294
<
277295

278296

297+
298+
279299
ALTERNATIVES AND COMPARISON*lua-console.nvim-💻-lua-console-main-develop-luarocks-alternatives-and-comparison*
280300

281301
There are a number of alternatives available, notably:
@@ -291,6 +311,8 @@ them, like REPL / scratch pad / code runner / debug console, while leaving the
291311
UX and config simple.
292312

293313

314+
315+
294316
🔥 ALL FEEDBACK AND FEATURE REQUESTS ARE VERY WELCOME! ENJOY!*lua-console.nvim-💻-lua-console-main-develop-luarocks-🔥-all-feedback-and-feature-requests-are-very-welcome!-enjoy!*
295317

296318
Generated by panvimdoc <https://github.com/kdheepak/panvimdoc>

doc/lua-console.nvim_api.txt

Lines changed: 13 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -36,37 +36,35 @@ Parameters ~
3636
{buf} `(number)`
3737

3838
------------------------------------------------------------------------------
39-
*get_assignment()*
40-
41-
`get_assignment`({line})
39+
*get_line_assignment()*
4240

41+
`get_line_assignment`({line})
4342

4443
if there is an assigment on the line and returns its value
45-
Parameters ~
46-
{line} `(string[])`
47-
48-
------------------------------------------------------------------------------
49-
*append_current_buffer()*
50-
51-
`append_current_buffer`({buf}, {lines})
52-
53-
Parameters ~
54-
{buf} `(number)`
55-
{lines} `(string[])` Text to append to current buffer after current selection
44+
line string[]
5645

5746
------------------------------------------------------------------------------
5847
*pretty_print()*
5948

6049
`pretty_print`({...})
6150

6251

63-
prints objects and appends to print_buffer
52+
prints objects
6453
Parameters ~
6554
{...} `(any[])`
6655

6756
Return ~
6857
`(string[])`
6958

59+
------------------------------------------------------------------------------
60+
*append_current_buffer()*
61+
62+
`append_current_buffer`({buf}, {lines})
63+
64+
Parameters ~
65+
{buf} `(number)`
66+
{lines} `(string[])` Text to append to current buffer after current selection
67+
7068
------------------------------------------------------------------------------
7169
*clean_stacktrace()*
7270

doc/tags

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,9 @@ attach_toggle() lua-console.nvim_api.txt /*attach_toggle()*
33
clean_stacktrace() lua-console.nvim_api.txt /*clean_stacktrace()*
44
default_handler() lua-console.nvim_api.txt /*default_handler()*
55
eval_code_in_buffer() lua-console.nvim_api.txt /*eval_code_in_buffer()*
6-
get_assignment() lua-console.nvim_api.txt /*get_assignment()*
76
get_external_evaluator() lua-console.nvim_api.txt /*get_external_evaluator()*
87
get_lang() lua-console.nvim_api.txt /*get_lang()*
8+
get_line_assignment() lua-console.nvim_api.txt /*get_line_assignment()*
99
load_messages() lua-console.nvim_api.txt /*load_messages()*
1010
load_saved_console() lua-console.nvim_api.txt /*load_saved_console()*
1111
lua-console.nvim-table-of-contents lua-console.nvim.txt /*lua-console.nvim-table-of-contents*

0 commit comments

Comments
 (0)