👍 deno task gen

Author: lambdalisue

denops_std/function/_generated.ts

@@ -70,6 +70,9 @@ export interface GetBufInfoDictArg {
  *
  *     :let failed = appendbufline(13, 0, "# THE START")
  *
+ * However, when **{text}** is an empty list then no error is given
+ * for an invalid **{lnum}**, since **{lnum}** isn't actually used.
+ *
  * Can also be used as a `method` after a List, the base is
  * passed as the second argument:
  *
@@ -295,7 +298,8 @@ export async function bufnr(
  *
  *     echo "A window containing buffer 1 is " .. (bufwinid(1))
  *
- * Only deals with the current tab page.
+ * Only deals with the current tab page.  See `win_findbuf()` for
+ * finding more.
  *
  * Can also be used as a `method`:
  *
@@ -460,7 +464,8 @@ export async function getbufinfo(
 /**
  * Return a `List` with the lines starting from **{lnum}** to **{end}**
  * (inclusive) in the buffer **{buf}**.  If **{end}** is omitted, a
- * `List` with only the line **{lnum}** is returned.
+ * `List` with only the line **{lnum}** is returned.  See
+ * `getbufoneline()` for only getting the line.
  *
  * For the use of **{buf}**, see `bufname()` above.
  *
@@ -607,9 +612,10 @@ export async function getmarklist(
  * To insert lines use `appendbufline()`.
  * Any text properties in **{lnum}** are cleared.
  *
- * **{text}** can be a string to set one line, or a list of strings
- * to set multiple lines.  If the list extends below the last
- * line then those lines are added.
+ * **{text}** can be a string to set one line, or a List of strings
+ * to set multiple lines.  If the List extends below the last
+ * line then those lines are added.  If the List is empty then
+ * nothing is changed and zero is returned.
  *
  * For the use of **{buf}**, see `bufname()` above.
  *

denops_std/function/buffer.ts

@@ -228,7 +228,8 @@ export async function has(
  *
  *     ComputeLnum()->getline()
  *
- * To get lines from another buffer see `getbufline()`
+ * To get lines from another buffer see `getbufline()` and
+ * `getbufoneline()`
  */
 export async function getline(
   denops: Denops,
@@ -256,7 +257,8 @@ export async function getline(
  * When **{lnum}** is just below the last line the **{text}** will be
  * added below the last line.
  * **{text}** can be any type or a List of any type, each item is
- * converted to a String.
+ * converted to a String.  When **{text}** is an empty List then
+ * nothing is changed and FALSE is returned.
  *
  * If this succeeds, FALSE is returned.  If this fails (most likely
  * because **{lnum}** is invalid) TRUE is returned.

denops_std/function/common.ts

@@ -17,6 +17,8 @@ import type { Position, ScreenPos } from "./types.ts";
  * and column number. Most useful when the column is "$", to get
  * the last column of a specific line.  When "lnum" or "col" is
  * out of range then col() returns zero.
+ * With the optional **{winid}** argument the values are obtained for
+ * that window instead of the current window.
  * To get the line number use `line()`.  To get both use
  * `getpos()`.
  * For the screen column position use `virtcol()`.  For the
@@ -29,17 +31,16 @@ import type { Position, ScreenPos } from "./types.ts";
  *     col("'t")               column of mark t
  *     col("'" .. markname)    column of mark markname
  *
- * The first column is 1.  Returns 0 if **{expr}** is invalid.
+ * The first column is 1.  Returns 0 if **{expr}** is invalid or when
+ * the window with ID **{winid}** is not found.
  * For an uppercase mark the column may actually be in another
  * buffer.
  * For the cursor position, when 'virtualedit' is active, the
  * column is one higher if the cursor is after the end of the
- * line.  This can be used to obtain the column in Insert mode:
+ * line.  Also, when using a `<Cmd>` mapping the cursor isn't
+ * moved, this can be used to obtain the column in Insert mode:
  *
- *     :imap <F2> <C-O>:let save_ve = &ve<CR>
- *             \<C-O>:set ve=all<CR>
- *             \<C-O>:echo col(".") .. "\n" <Bar>
- *             \let &ve = save_ve<CR>
+ *     :imap <F2> <Cmd>echowin col(".")<CR>
  *
  * Can also be used as a `method`:
  *
@@ -207,10 +208,10 @@ export async function winline(denops: Denops): Promise<number> {
  * `setcursorcharpos()`.
  *
  * Does not change the jumplist.
- * **{lnum}** is used like with `getline()`.
+ * **{lnum}** is used like with `getline()`, except that if **{lnum}** is
+ * zero, the cursor will stay in the current line.
  * If **{lnum}** is greater than the number of lines in the buffer,
  * the cursor will be positioned at the last line in the buffer.
- * If **{lnum}** is zero, the cursor will stay in the current line.
  * If **{col}** is greater than the number of bytes in the line,
  * the cursor will be positioned at the last character in the
  * line.