summaryrefslogtreecommitdiff
path: root/rc/tools/doc.kak
AgeCommit message (Collapse)Author
2024-03-15rc tools doc: use menu behavior for completion againJohannes Altmanninger
Commit e43c7d6ab (Use complete-command for the :doc command, 2022-10-19) forgot to carry over the "-menu" flag, which means that :doc completions are no longer auto-selected, even though they are the only valid inputs. Fix that. Closes #4790
2023-12-02ranked match: prefer input order over alphabetical order for user-specified ↵Johannes Altmanninger
completions When using either of set-option g completers option=my_option prompt -shell-script-candidates ... While the search text is empty, the completions will be sorted alphabetically. This is bad because it means the most important entries are not listed first, making them harder to select or even spot. Let's apply input order before resorting to sorting alphabetically. In theory there is a more elegant solution: sort candidates (except if they're user input) before passing them to RankedMatch, and then always use stable sort. However that doesn't work because we use a heap which doesn't support stable sort. Closes #1709, #4813
2023-06-23Quote doc file path in doc-render commandGrant Moyer
Without quoting the file path, the `doc` command fails to display any docs with spaces or backslashs (on Cygwin) in their paths.
2022-10-19Use complete-command for the :doc commandMaxime Coste
2022-09-09Merge remote-tracking branch 'krobelus/embrace-menu-3'Maxime Coste
2022-08-01Remove unnecessary leading space in prompt from mappingsJohannes Altmanninger
We often use the pattern «map global normal ": foo"». The space after the colon is unnecessary since execution of the mapping won't add to history anyway, since 217dd6a1d (Disable history when executing maps, 2015-11-10). With the parent commit, the space is no longer necessary for user mappings, so there is no reason to continue the cargo-cult. Remove the space from mappings to set a good example.
2022-07-30Use menu behavior when completing docJohannes Altmanninger
We can complete every valid argument.
2021-09-16rc doc: Don't spawn processes unecessarilyFrank LENORMAND
2021-09-16rc doc: Hide errors on missing directoriesFrank LENORMAND
Fixes #4273.
2021-05-02doc: small UX improvements.Markus F.X.J. Oberhumer
Place the cursor at the beginning of the file (and not at the end of the first line) and improve error message in case of failure.
2021-04-26rc doc: do not require arguments for ":doc" or ":help"Markus F.X.J. Oberhumer
When no arguments are given simply run ":doc doc".
2020-12-17rc doc: Hide private commandsFrank LENORMAND
2020-11-11Merge remote-tracking branch 'ManDay/master' into masterMaxime Coste
2020-11-02doc.kak: Render links and other elements with a single ranges highlighterMaxime Coste
2020-10-27Disabled backtick escapingCedric Sodhi
Fixes issue #2377 by removing the ability to escape backticks in backticks in compliance with asciidoc's behaviour. Adjusted hooks.asciidoc, keys.asciidoc, and command-parsing.asciidoc to match accordingly.
2020-09-04Reference content goes in docstrings, explanations go in prose docs.Tim Allen
Also, make sure docstrings reference the prose docs, so people who stumble over an interesting-looking command or option can find out more about it.
2020-09-03Address code-review commentsTim Allen
- some wording changes in included documentation - find supports multiple starting paths, we don't need to launch it 3 times - Change the regex that trims the file extension to only trim the last extension Some additional things I noticed: - find should use -L to see through symlinks like the autoload processing does. - find should check the user's autoload directory first, so users can override Kakoune's built-in documentation.
2020-09-03doc.kak: Also search through plugins (stdlib and per-user) for docs.Tim Allen
This makes the somewhat-dubious assumption that every plugin will have uniquely- named documentation files, instead of automatically putting every plugin's docs into a namespace. However, plugins already have to deal with flat namespaces for commands, options, filetypes, etc. so one more shouldn't hurt. Fixes #2466.
2020-08-24Avoid accidentally using environment variables in sh scopesJohannes Altmanninger
On the instances with altfile this was already the case, but this makes it more obvious. Closes #3673
2020-06-03src: Introduce a <percent> named keyFrank LENORMAND
Similarly to the <semicolon> key, make it easier to write `:execute-keys` commands by replacing <percent> with `%`. Highlighters can keep escaping the sign when regular expressions are not quoted, but built-in scripts that use `%` as an editing primitive have been modified to use the named key, for clarity.
2020-02-18Fix doc paragraph rewrappingMaxime Coste
2020-02-03rc: Make docstrings more readableFrank LENORMAND
This cosmetics commit makes use of the auto-deindentation syntax, available to docstrings.
2019-11-14rc: Use the standard `fail` command to report errorsFrank LENORMAND
Merely using `echo` with markup doesn't log errors in the debug buffers, and is also less readable.
2019-06-23Make quoting opt-in by using $kak_quoted_...Maxime Coste
2019-03-21Add categories in rc/Alex Leferry 2
Closes #2783