vim-patch:9cd9e759ab1e (#28224)

runtime(doc): Normalise builtin-function optional parameter formatting

These should generally be formatted as func([{arg}]) and referenced as
{arg} in the description.

closes: vim/vim#14438

9cd9e759ab

Co-authored-by: Doug Kearns <dougkearns@gmail.com>
This commit is contained in:
zeertzjq
2024-04-08 06:11:31 +08:00
committed by GitHub
parent 067f51e3aa
commit d32cbef595
3 changed files with 36 additions and 36 deletions

View File

@@ -2703,14 +2703,14 @@ function vim.fn.getcellwidths() end
function vim.fn.getchangelist(buf) end
--- Get a single character from the user or input stream.
--- If [expr] is omitted, wait until a character is available.
--- If [expr] is 0, only get a character when one is available.
--- If {expr} is omitted, wait until a character is available.
--- If {expr} is 0, only get a character when one is available.
--- Return zero otherwise.
--- If [expr] is 1, only check if a character is available, it is
--- If {expr} is 1, only check if a character is available, it is
--- not consumed. Return zero if no character available.
--- If you prefer always getting a string use |getcharstr()|.
---
--- Without [expr] and when [expr] is 0 a whole character or
--- Without {expr} and when {expr} is 0 a whole character or
--- special key is returned. If it is a single character, the
--- result is a Number. Use |nr2char()| to convert it to a String.
--- Otherwise a String is returned with the encoded character.
@@ -2720,11 +2720,11 @@ function vim.fn.getchangelist(buf) end
--- also a String when a modifier (shift, control, alt) was used
--- that is not included in the character.
---
--- When [expr] is 0 and Esc is typed, there will be a short delay
--- When {expr} is 0 and Esc is typed, there will be a short delay
--- while Vim waits to see if this is the start of an escape
--- sequence.
---
--- When [expr] is 1 only the first byte is returned. For a
--- When {expr} is 1 only the first byte is returned. For a
--- one-byte character it is the character itself as a number.
--- Use nr2char() to convert it to a String.
---
@@ -2828,10 +2828,10 @@ function vim.fn.getcharsearch() end
--- Get a single character from the user or input stream as a
--- string.
--- If [expr] is omitted, wait until a character is available.
--- If [expr] is 0 or false, only get a character when one is
--- If {expr} is omitted, wait until a character is available.
--- If {expr} is 0 or false, only get a character when one is
--- available. Return an empty string otherwise.
--- If [expr] is 1 or true, only check if a character is
--- If {expr} is 1 or true, only check if a character is
--- available, it is not consumed. Return an empty string
--- if no character is available.
--- Otherwise this works like |getchar()|, except that a number
@@ -5993,7 +5993,7 @@ function vim.fn.min(expr) end
function vim.fn.mkdir(name, flags, prot) end
--- Return a string that indicates the current mode.
--- If [expr] is supplied and it evaluates to a non-zero Number or
--- If {expr} is supplied and it evaluates to a non-zero Number or
--- a non-empty String (|non-zero-arg|), then the full mode is
--- returned, otherwise only the first letter is returned.
--- Also see |state()|.