From 7678f08fc8d26119a86772a2f47bd570fbcf18c4 Mon Sep 17 00:00:00 2001 From: h-east Date: Sun, 30 Nov 2025 22:24:48 +0900 Subject: [PATCH] Update builtin.{txt,jax} --- doc/builtin.jax | 56 ++++++------------------------------------------ en/builtin.txt | 57 ++++++------------------------------------------- 2 files changed, 12 insertions(+), 101 deletions(-) diff --git a/doc/builtin.jax b/doc/builtin.jax index 721b56d0a..4f68ec60b 100644 --- a/doc/builtin.jax +++ b/doc/builtin.jax @@ -1,4 +1,4 @@ -*builtin.txt* For Vim バージョン 9.1. Last change: 2025 Nov 09 +*builtin.txt* For Vim バージョン 9.1. Last change: 2025 Nov 28 VIM リファレンスマニュアル by Bram Moolenaar @@ -149,7 +149,6 @@ complete({startcol}, {matches}) なし 挿入モード補完を設定する complete_add({expr}) 数値 補完候補を追加する complete_check() 数値 補完中に押されたキーをチェックする complete_info([{what}]) 辞書 現在の補完情報を取得 -complete_match([{lnum}, {col}]) リスト 補完のカラムとトリガー文字列を取得 confirm({msg} [, {choices} [, {default} [, {type}]]]) 数値 ユーザーへの選択肢と番号 copy({expr}) 任意 {expr}の浅いコピーを作る @@ -984,8 +983,8 @@ appendbufline({buf}, {lnum}, {text}) *appendbufline()* < ただし、{text} が空のリストの場合、{lnum} は実際には使用されな いため、無効な {lnum} に対してエラーは発生しない。 - リストの後に |method| としても使用でき、ベースは第2引数として - 渡される: > + リストの後に |method| としても使用でき、ベースは第 3 引数とし + て渡される: > mylist->appendbufline(buf, lnum) < 戻り値の型: |Number| @@ -2112,50 +2111,6 @@ complete_info([{what}]) *complete_info()* < 戻り値の型: dict -complete_match([{lnum}, {col}]) *complete_match()* - 指定された位置から後方に検索し、'isexpand' オプションに従って - マッチした文字列のリストを返す。引数が指定されていない場合は、 - 現在のカーソル位置を使用する。 - - 各マッチは、[startcol, trigger_text] を含むリストとして表され - る: - - startcol: 補完を開始する桁位置。トリガー位置が見つからない場 - 合は -1 を返す。複数文字のトリガーの場合は、最初の文字の桁を - 返す。 - - trigger_text: 'isexpand' からのマッチするトリガー文字列、ま - たはマッチするものが見つからなかったか、デフォルトの - 'iskeyword' パターンを使用している場合は空の文字列。 - - 'isexpand' が空の場合、'iskeyword' のパターン "\k\+$" を使用し - て現在のキーワードの開始位置を検索する。 - - 例: > - set isexpand=.,->,/,/*,abc - func CustomComplete() - let res = complete_match() - if res->len() == 0 | return | endif - let [col, trigger] = res[0] - let items = [] - if trigger == '/*' - let items = ['/** */'] - elseif trigger == '/' - let items = ['/*! */', '// TODO:', '// fixme:'] - elseif trigger == '.' - let items = ['length()'] - elseif trigger =~ '^\->' - let items = ['map()', 'reduce()'] - elseif trigger =~ '^\abc' - let items = ['def', 'ghk'] - endif - if items->len() > 0 - let startcol = trigger =~ '^/' ? col : col + len(trigger) - call complete(startcol, items) - endif - endfunc - inoremap call CustomComplete() -< - 戻り値の型: list> - confirm({msg} [, {choices} [, {default} [, {type}]]]) *confirm()* confirm()はユーザーに選択させるためのダイアログを提供する。戻 @@ -6718,8 +6673,9 @@ listener_add({callback} [, {buf} [, {unbuffered}]]) *listener_add()* に表示される。 上記のコールバックをトリガーする 3 番目の理由により、コールバッ - クに渡される行番号の有効性が保証されない。これが問題となる場合 - は、{unbuffered} を |TRUE| に設定すること。 + クに渡される行番号の有効性は保証されない。特に、終了値は + line('$') + 1 よりも大きくなる可能性がある。これが問題となる場 + 合は、{unbuffered} を |TRUE| に設定すること。 {unbuffered} が |TRUE| の場合、変更ごとに {callback} が呼び出 される。変更リストは単一の辞書のみを保持し、辞書内の "start"、 diff --git a/en/builtin.txt b/en/builtin.txt index 229832c9d..90f873e1d 100644 --- a/en/builtin.txt +++ b/en/builtin.txt @@ -1,4 +1,4 @@ -*builtin.txt* For Vim version 9.1. Last change: 2025 Nov 09 +*builtin.txt* For Vim version 9.1. Last change: 2025 Nov 28 VIM REFERENCE MANUAL by Bram Moolenaar @@ -136,7 +136,6 @@ complete({startcol}, {matches}) none set Insert mode completion complete_add({expr}) Number add completion match complete_check() Number check for key typed during completion complete_info([{what}]) Dict get current completion information -complete_match([{lnum}, {col}]) List get completion column and trigger text confirm({msg} [, {choices} [, {default} [, {type}]]]) Number number of choice picked by user copy({expr}) any make a shallow copy of {expr} @@ -909,7 +908,7 @@ appendbufline({buf}, {lnum}, {text}) *appendbufline()* 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: > + passed as the third argument: > mylist->appendbufline(buf, lnum) < Return type: |Number| @@ -2072,51 +2071,6 @@ complete_info([{what}]) *complete_info()* Return type: dict -complete_match([{lnum}, {col}]) *complete_match()* - Searches backward from the given position and returns a List - of matches according to the 'isexpand' option. When no - arguments are provided, uses the current cursor position. - - Each match is represented as a List containing - [startcol, trigger_text] where: - - startcol: column position where completion should start, - or -1 if no trigger position is found. For multi-character - triggers, returns the column of the first character. - - trigger_text: the matching trigger string from 'isexpand', - or empty string if no match was found or when using the - default 'iskeyword' pattern. - - When 'isexpand' is empty, uses the 'iskeyword' pattern "\k\+$" - to find the start of the current keyword. - - Examples: > - set isexpand=.,->,/,/*,abc - func CustomComplete() - let res = complete_match() - if res->len() == 0 | return | endif - let [col, trigger] = res[0] - let items = [] - if trigger == '/*' - let items = ['/** */'] - elseif trigger == '/' - let items = ['/*! */', '// TODO:', '// fixme:'] - elseif trigger == '.' - let items = ['length()'] - elseif trigger =~ '^\->' - let items = ['map()', 'reduce()'] - elseif trigger =~ '^\abc' - let items = ['def', 'ghk'] - endif - if items->len() > 0 - let startcol = trigger =~ '^/' ? col : col + len(trigger) - call complete(startcol, items) - endif - endfunc - inoremap call CustomComplete() -< - Return type: list> - - confirm({msg} [, {choices} [, {default} [, {type}]]]) *confirm()* confirm() offers the user a dialog, from which a choice can be made. It returns the number of the choice. For the first @@ -6819,9 +6773,10 @@ listener_add({callback} [, {buf} [, {unbuffered}]]) *listener_add()* The entries are in the order the changes were made, thus the most recent change is at the end. - Because of the third trigger reason for triggering a callback - listed above, the line numbers passed to the callback are not - guaranteed to be valid. If this is a problem then make + Because of the third reason for triggering a callback listed + above, the line numbers passed to the callback are not + guaranteed to be valid. In particular, the end value can be + greater than line('$') + 1. If this is a problem then make {unbuffered} |TRUE|. When {unbuffered} is |TRUE| the {callback} is invoked for every