Update {popup,print,quickfix,recover,repeat,windows}.{txt,jax} and quickref.txt

doc/popup.jax

@@ -1,4 +1,4 @@
-*popup.txt*  For Vim バージョン 8.2.  Last change: 2020 Jul 27
+*popup.txt*  For Vim バージョン 8.2.  Last change: 2020 Nov 07
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -102,7 +102,7 @@ Exコマンドの出力のために画面がスクロールアップすると、
 通常、ポップアップウィンドウを作成したプラグインは、それを閉じることも担当す
 る。何らかの理由でポップアップが表示される場合は、次のコマンドですべてを閉じる
 ことができる: >
-	call popup_clear()
+	call popup_clear(1)
 通知などの一部のポップアップは、指定した時間が経過すると閉じる。これは、
 `popup_create()` の "time" プロパティで設定できる。
 それ以外の場合は、右上隅の X をクリックするか、ポップアップ内の任意の場所をク
@@ -312,11 +312,12 @@ popup_dialog({what}, {options})				*popup_dialog()*
 
 popup_filter_menu({id}, {key})				*popup_filter_menu()*
 		ポップアップに使用できるフィルタ。これらのキーが使用できる:
-		    j <Down>		下の項目を選択する
-		    k <Up>		上の項目を選択する
+		    j <Down> <C-N>	下の項目を選択する
+		    k <Up> <C-P>	上の項目を選択する
 		    <Space> <Enter>	現在の選択を受け入れる
 		    x Esc CTRL-C	メニューをキャンセルする
 		他のキーは無視される。
+		常に |v:true| を返す。
 
 		行をハイライトするためにマッチがセットされる。|popup_menu()|
 		を参照。
@@ -591,8 +592,6 @@ POPUP_CREATE() の引数				 *popup_create-arguments*
 
 自分で新しいバッファを作成したい場合は、|bufadd()| を使用して、バッファ番号を
 popup_create() に渡す。
-端末ウィンドウのバッファを使用することはできない。 *E278* 隠した状態の端末バッ
-ファを作ってポップアップウィンドウに使うことができる。
 
 |popup_create()| の第2引数は任意の辞書である:
 	line		ポップアップを配置する画面の行。数値または、カーソルの
@@ -705,9 +704,9 @@ popup_create() に渡す。
 			'encoding' が "utf-8" かつ 'ambiwidth' が "single" の
 			ときはデフォルトで2重線が使われる。それ以外の場合は
 			ASCII文字が使われる。
-	scrollbar	0 以外: テキストが収まらない場合にスクロールバーを表示
-			する。0: スクロールバーを表示しない。デフォルトは 0以
-			外である。|popup-scrollbar| も参照。
+	scrollbar	1か true: テキストが収まらない場合にスクロールバーを
+			表示する。0: スクロールバーを表示しない。デフォルトは
+			0以外である。|popup-scrollbar| も参照。
 	scrollbarhighlight  スクロールバー用のハイライトグループ名。背景色が重
 			要である。指定しない場合、PmenuSbar が使用される。
 	thumbhighlight  スクロールバーのつまみ用のハイライトグループ名。背景色
@@ -898,11 +897,22 @@ zindex を持つポップアップウィンドウのフィルタが最初に呼
 Vimは標準のフィルタ |popup_filter_menu()| と |popup_filter_yesno()| を提供す
 る。
 
+キーは `:normal` からフィルターをすり抜けないでくる。これは "cursorline" が設
+定されているならポップアップ内でカーソルを動かすことに使える: >
+	call win_execute(winid, 'normal! 10Gzz')
+キーが `feedkeys()` からならフィルターをすり抜けてくる。
+
 Note "x" はポップアップを閉じる通常の方法である。Escを使いたくなるかもしれない
 が、多くのキーはEsc文字で始まるので、VimがEscキーを認識するまでに時間がかかる
 ことがある。Escを使用する場合は、'ttimeoutlen' オプションを 100 に設定し、
 'timeout' または 'ttimeout'、あるいはその両方を設定することを薦める。
 
+							*popup-filter-errors*
+フィルター関数は、たとえば名前が正しくないなどで、呼ばれないことがあり、その時
+はポップアップを閉じます。フィルターが原因のエラーの時は0を返します。もしある
+行で3度発生したらポップアップは閉じられます。ポップアップでの呼び出しでエラー
+が10%未満であるなら、閉じられません。
+
 
 ポップアップコールバック				*popup-callback*
 

doc/print.jax

@@ -1,4 +1,4 @@
-*print.txt*     For Vim バージョン 8.2.  Last change: 2019 Dec 17
+*print.txt*     For Vim バージョン 8.2.  Last change: 2020 Aug 15
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar

doc/quickref.jax

@@ -1,4 +1,4 @@
-*quickref.txt*  For Vim バージョン 8.2.  Last change: 2020 Jun 10
+*quickref.txt*  For Vim バージョン 8.2.  Last change: 2020 Aug 15
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar

doc/recover.jax

@@ -1,4 +1,4 @@
-*recover.txt*   For Vim バージョン 8.2.  Last change: 2020 May 09
+*recover.txt*   For Vim バージョン 8.2.  Last change: 2020 Aug 15
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -64,8 +64,8 @@ Vimは変更した箇所をスワップファイルに蓄える。編集を開
   れを避けようとするが)。
   これによって偽の注意メッセージが表示される。
 - あなたがホームディレクトリで作業をしていて、他の誰かが同じファイルを編集しよ
-  うとしたとき、その人はあなたのスワップファイルに気づかないし、注意のメッセー
-  ジも表示されない。
+  うとしたとき、そのユーザーはあなたのスワップファイルに気づかないし、注意の
+  メッセージも表示されない。
 Amigaでは、回復可能なramディスクを使えるが、それが100％働くという保証はない。
 スワップファイルを通常のramディスク(AmigaではRAM:など)に置いたり、リブートに
 よって消されてしまう場所(Unixの/tmpなど)に置くことは無意味であり、クラッシュに

doc/repeat.jax

@@ -1,4 +1,4 @@
-*repeat.txt*    For Vim バージョン 8.2.  Last change: 2020 May 14
+*repeat.txt*    For Vim バージョン 8.2.  Last change: 2021 Jan 02
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -269,6 +269,9 @@ Vim script の書き方はユーザーマニュアルの41章|usr_41.txt|を参
 			く場合は便利である。追加されたプラグインは初期化時に読
 			み込まれる。|load-plugins|を参照。また|pack-add|も参照。
 			{|+eval| 機能付きでコンパイルされたときのみ有効}
+			Note ftdetect スクリプトがロードされるようにするには、
+			`filetype plugin indent on` を全 `packadd!` の _後に_
+			書く必要がある。
 
 						*:packl* *:packloadall*
 :packl[oadall][!]	'packpath' 以下の "start" ディレクトリ中の全パッケージ
@@ -344,6 +347,14 @@ Vim script の書き方はユーザーマニュアルの41章|usr_41.txt|を参
 			しいバージョンに更新する必要がある。バージョン間の変更
 			点については |vimscript-version| を参照。
 
+:vim9script [noclear]				*:vim9* *:vim9script*
+			|Vim9-script| のコマンドががスクリプトファイルに含まれ
+			ることをマークする。|vim9-namespace| も参照。
+			ファイルの先頭のコマンドである必要がある。
+			[noclear] については |vim9-reload| を参照。
+			いくつかのコマンドはこの文法の変更で |+eval| 機能が不
+			要になる。
+
 						*:scr* *:scriptnames*
 :scr[iptnames]		読み込まれているスクリプトを読み込まれた順番どおりに
 			全て表示する。数字はスクリプトのID(識別子)|<SID>|に使
@@ -635,8 +646,8 @@ Filetype プラグインはファイルタイプに複数のプラグインが
 
 2つの無関係なプラグインがある場合は、2つのパッケージを使用するので、Vimユー
 ザーはそのパッケージに含まれるものを選択できる。あるいは、オプションのプラグイ
-ンで1つのパッケージを使用し、`:packadd` で必要なプラグインを追加するようにユー
-ザーに指示することもできる。
+ンで1つのパッケージを使用し、`:packadd` で推奨するプラグインを追加するように
+ユーザーに指示することもできる。
 
 パッケージの配布方法を決める。アーカイブを作成することも、リポジトリを使用する
 こともできる。より多くのユーザーがアーカイブを使用できるが、新しいバージョンに

doc/windows.jax

@@ -1,4 +1,4 @@
-*windows.txt*   For Vim バージョン 8.2.  Last change: 2020 May 10
+*windows.txt*   For Vim バージョン 8.2.  Last change: 2020 Dec 18
 
 
 		  VIMリファレンスマニュアル    by Bram Moolenaar
@@ -214,11 +214,6 @@ CTRL-W CTRL_N						*CTRL-W_CTRL-N*
 		この動作は、はじめに ":split"、次に ":enew" コマンドを実行した
 		場合と同じ動作である。
 
-:[N]vne[w] [++opt] [+cmd] [file]			*:vne* *:vnew*
-		|:new|と同様だが、垂直分割する。'equalalways' がセットされ、
-		'eadirection' が "ver" でないならば、幅が指定されない限りウィ
-		ンドウは水平に広げられる。
-
 :[N]new [++opt] [+cmd] {file}
 :[N]sp[lit] [++opt] [+cmd] {file}			*:split_f*
 		新しいウィンドウを作成し、そのウィンドウでファイル {file} の編
@@ -232,6 +227,11 @@ CTRL-W CTRL_N						*CTRL-W_CTRL-N*
                 レントウィンドウの高さは低くなる。('equalalways' オプションが
                 セットされていれば他のウィンドウも低くなる)
 
+:[N]vne[w] [++opt] [+cmd] [file]			*:vne* *:vnew*
+		|:new|と同様だが、垂直分割する。'equalalways' がセットされ、
+		'eadirection' が "ver" でないならば、幅が指定されない限りウィ
+		ンドウは水平に広げられる。
+
 :[N]sv[iew] [++opt] [+cmd] [file]		*:sv* *:sview* *splitview*
 		":split" と同じ。ただし、バッファに対して 'readonly' オプショ
 		ンがセットされる。
@@ -974,13 +974,13 @@ CTRL-W g }						*CTRL-W_g}*
 		関する情報を自動的に表示させることができる。これは |:ptag| コ
 		マンドを使うほど賢くないが、tags ファイルが必要なく、システム
 		インクルードファイル内のマッチを見つけることもできる。例: >
-  :au! CursorHold *.[ch] nested exe "silent! psearch " . expand("<cword>")
+  :au! CursorHold *.[ch] ++nested exe "silent! psearch " . expand("<cword>")
 <		注意:遅いかもしれない。
 
 
 例							*CursorHold-example*
 
-  :au! CursorHold *.[ch] nested exe "silent! ptag " . expand("<cword>")
+  :au! CursorHold *.[ch] ++nested exe "silent! ptag " . expand("<cword>")
 
 この例では、'updatetime' に設定された時間の間カーソルが動かなければ、カーソル
 下のキーワードで ":ptag" が実行される。"nested" は他の自動コマンドを実行するの
@@ -993,7 +993,7 @@ CTRL-W g }						*CTRL-W_g}*
 見つかったタグをハイライトさせる、カーソル位置に単語がないときに ":ptag" を実
 行しない、などの改良をしたものが以下の通り: >
 
-  :au! CursorHold *.[ch] nested call PreviewWord()
+  :au! CursorHold *.[ch] ++nested call PreviewWord()
   :func PreviewWord()
   :  if &previewwindow			" プレビューウィンドウ内では実行しない
   :    return
@@ -1134,10 +1134,12 @@ CTRL-W g }						*CTRL-W_g}*
 <
 						*:bad* *:badd*
 :bad[d]	[+lnum] {fname}
-		ファイル名 {fname} をバッファリストに追加する。ただし、メモリ
-		上には読み込まれない。"lnum" が指定された場合、バッファに初め
-		て移動したときにカーソルが指定された行番号にジャンプする。+ 以
-		降の他のコマンドは無視されることに注意。
+		ファイル名 {fname} をバッファリストに追加する、ただしメモリ上
+		には読み込まず、リストもされない。そのバッファが以前に削除さ
+		れ、しかしワイプれてないなら、再度リストされる。
+		"lnum" が指定された場合、バッファに初めて移動したときにカーソ
+		ルが指定された行番号にジャンプする。Note + 以降の他のコマンド
+		は無視される。
 
 :[N]bd[elete][!]			*:bd* *:bdel* *:bdelete* *E516*
 :bd[elete][!] [N]

en/popup.txt

@@ -1,4 +1,4 @@
-*popup.txt*  For Vim version 8.2.  Last change: 2020 Jul 27
+*popup.txt*  For Vim version 8.2.  Last change: 2020 Nov 07
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -101,7 +101,7 @@ CLOSING THE POPUP WINDOW				*popup-close*
 
 Normally the plugin that created the popup window is also in charge of closing
 it.  If somehow a popup hangs around, you can close all of them with: >
-	call popup_clear()
+	call popup_clear(1)
 Some popups, such as notifications, close after a specified time.  This can be
 set with the "time" property on `popup_create()`.
 Otherwise, a popup can be closed by clicking on the X in the top-right corner
@@ -309,11 +309,12 @@ popup_dialog({what}, {options})				*popup_dialog()*
 
 popup_filter_menu({id}, {key})				*popup_filter_menu()*
 		Filter that can be used for a popup. These keys can be used:
-		    j <Down>		select item below
-		    k <Up>		select item above
+		    j <Down> <C-N>	select item below
+		    k <Up> <C-P>	select item above
 		    <Space> <Enter>	accept current selection
 		    x Esc CTRL-C	cancel the menu
 		Other keys are ignored.
+		Always returns |v:true|.
 
 		A match is set on that line to highlight it, see
 		|popup_menu()|.
@@ -587,8 +588,6 @@ properties.  It is in one of four forms:
 
 If you want to create a new buffer yourself use |bufadd()| and pass the buffer
 number to popup_create().
-It is not possible to use the buffer of a terminal window. *E278*  You CAN
-create a hidden terminal buffer and use that one in a popup window.
 
 The second argument of |popup_create()| is a dictionary with options:
 	line		Screen line where to position the popup.  Can use a
@@ -711,7 +710,7 @@ The second argument of |popup_create()| is a dictionary with options:
 			By default a double line is used all around when
 			'encoding' is "utf-8" and 'ambiwidth' is "single",
 			otherwise ASCII characters are used.
-	scrollbar	non-zero: show a scrollbar when the text doesn't fit.
+	scrollbar	1 or true: show a scrollbar when the text doesn't fit.
 			zero: do not show a scrollbar.  Default is non-zero.
 			Also see |popup-scrollbar|.
 	scrollbarhighlight  Highlight group name for the scrollbar. The
@@ -910,11 +909,22 @@ A mouse click arrives as <LeftMouse>.  The coordinates can be obtained with
 Vim provides standard filters |popup_filter_menu()| and
 |popup_filter_yesno()|.
 
+Keys coming from a `:normal` command do not pass through the filter.  This can
+be used to move the cursor in a popup where the "cursorline" option is set: >
+	call win_execute(winid, 'normal! 10Gzz')
+Keys coming from `feedkeys()` are passed through the filter.
+
 Note that "x" is the normal way to close a popup.  You may want to use Esc,
 but since many keys start with an Esc character, there may be a delay before
 Vim recognizes the Esc key.  If you do use Esc, it is recommended to set the
 'ttimeoutlen' option to 100 and set 'timeout' and/or 'ttimeout'.
 
+							*popup-filter-errors*
+If the filter function can't be called, e.g. because the name is wrong, then
+the popup is closed.  If the filter causes an error then it is assumed to
+return zero.  If this happens three times in a row the popup is closed.  If
+the popup gives errors fewer than 10% of the calls then it won't be closed.
+
 
 POPUP CALLBACK						*popup-callback*
 

en/print.txt

@@ -1,4 +1,4 @@
-*print.txt*     For Vim version 8.2.  Last change: 2019 Dec 17
+*print.txt*     For Vim version 8.2.  Last change: 2020 Aug 15
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -114,7 +114,7 @@ If 'printencoding' is empty or Vim cannot find the file then it will use
 encoding file.  If Vim is unable to find a character encoding file then it
 will use the "latin1" print character encoding file.
 
-When 'encoding' is set to a multi-byte encoding, Vim will try to convert
+When 'encoding' is set to a multibyte encoding, Vim will try to convert
 characters to the printing encoding for printing (if 'printencoding' is empty
 then the conversion will be to latin1).  Conversion to a printing encoding
 other than latin1 will require Vim to be compiled with the |+iconv| feature.
@@ -269,7 +269,7 @@ Japanese text you would do the following; >
 	:set printmbcharset=JIS_X_1983
 
 If 'printmbcharset' is not one of the above values then it is assumed to
-specify a custom multi-byte character set and no check will be made that it is
+specify a custom multibyte character set and no check will be made that it is
 compatible with the value for 'printencoding'.  Vim will look for a file
 defining the character set in the "print" directory in 'runtimepath'.
 
@@ -304,7 +304,7 @@ printing of characters in the ASCII code range.
   a:yes			Use ASCII character set for codes in the ASCII
   a:no (default)	code range.
 
-The following is an example of specifying two multi-byte fonts, one for normal
+The following is an example of specifying two multibyte fonts, one for normal
 and italic printing and one for bold and bold-italic printing, and using
 Courier to print codes in the ASCII code range but using the national
 character set: >
@@ -420,10 +420,10 @@ There are currently a number of limitations with PostScript printing:
   possible to get all the characters in an encoding to print by installing a
   new version of the Courier font family.
 
-- Multi-byte support - Currently Vim will try to convert multi-byte characters
+- Multi-byte support - Currently Vim will try to convert multibyte characters
   to the 8-bit encoding specified by 'printencoding' (or latin1 if it is
   empty).  Any characters that are not successfully converted are shown as
-  unknown characters.  Printing will fail if Vim cannot convert the multi-byte
+  unknown characters.  Printing will fail if Vim cannot convert the multibyte
   to the 8-bit encoding.
 
 ==============================================================================
@@ -508,7 +508,7 @@ print ASCII text using the national character set you may see some unexpected
 characters.  If you want true ASCII code printing then you need to configure
 Vim to output ASCII characters for the ASCII code range with 'printmbfont'.
 
-It is possible to define your own multi-byte character set although this
+It is possible to define your own multibyte character set although this
 should not be attempted lightly.  A discussion on the process if beyond the
 scope of these help files.  You can find details on CMap (character map) files
 in the document 'Adobe CMap and CIDFont Files Specification, Version 1.0',

en/quickfix.txt

@@ -1705,7 +1705,7 @@ special problem here is that it doesn't print information on leaving the
 directory and that it doesn't print the absolute path.
 
 To solve the problem with relative paths and missing "leave directory"
-messages Vim uses following algorithm:
+messages Vim uses the following algorithm:
 
 1) Check if the given directory is a subdirectory of the current directory.
    If this is true, store it as the current directory.
@@ -1938,7 +1938,7 @@ list window is:
 The values displayed in each line correspond to the "bufnr", "lnum", "col" and
 "text" fields returned by the |getqflist()| function.
 
-For some quickfix/location lists, the displayed text need to be customized.
+For some quickfix/location lists, the displayed text needs to be customized.
 For example, if only the filename is present for a quickfix entry, then the
 two "|" field separator characters after the filename are not needed.  Another
 use case is to customize the path displayed for a filename. By default, the