Merge pull request #1313 from vim-jp/hh-update-indent

Update indent.{txt,jax}

doc/indent.jax

@@ -1,4 +1,4 @@
-*indent.txt*    For Vim バージョン 9.0.  Last change: 2022 May 21
+*indent.txt*    For Vim バージョン 9.0.  Last change: 2022 Oct 10
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -964,25 +964,40 @@ PHP では 'case/default' ブロックの中で波カッコは不要なので、
 
 PYTHON							*ft-python-indent*
 
-以下の状況のためにインデントの量を設定することができる。この例は既定である。
-後で 'shiftwidth' の値を変更するために変数に式を設定しておく。
+インデントの量は `g:python_indent` |Dictionary| で設定できる。これは項目を追加
+する前に作成する必要がある: >
+	let g:python_indent = {}
+示されている例はデフォルトである。Note 辞書の値は式に設定されているので、これ
+らの値を更新しなくても後で 'shiftwidth' の値を変更できることに注意。
 
 開き括弧の後のインデント: >
-	let g:pyindent_open_paren = 'shiftwidth() * 2'
+	let g:python_indent.open_paren = 'shiftwidth() * 2'
 ネストした括弧の後のインデント: >
-	let g:pyindent_nested_paren = 'shiftwidth()'
+	let g:python_indent.nested_paren = 'shiftwidth()'
 継続行のインデント: >
-	let g:pyindent_continue = 'shiftwidth() * 2'
+	let g:python_indent.continue = 'shiftwidth() * 2'
+
+デフォルトでは、複数行構成の閉じ括弧は、前の行の最初の非空白文字の下に並ぶ。
+複数行構成を開始する行の最初の文字の下に並べたい場合は、このキーをリセットする:
+>
+	let g:python_indent.closed_paren_align_last_line = v:false
 
 このメソッドは、|searchpair()| を使用して閉じられていない括弧に戻る。これは時々
 遅くなる可能性があるため、150ミリ秒後にタイムアウトする。もし、インデントが正
 しくないことに気付いた時は、より大きなタイムアウトをミリ秒で設定できる: >
-	let g:pyindent_searchpair_timeout = 500
+	let g:python_indent.searchpair_timeout = 500
 
 閉じ括弧を遡って振り返るのがまだ遅すぎる場合、特にコピー&ペースト操作の間、あ
 るいは複数行の括弧の内側をインデントする必要がない場合は、この機能を完全に無効
 にすることができる: >
-	let g:pyindent_disable_parentheses_indenting = 1
+	let g:python_indent.disable_parentheses_indenting = 1
+
+後方互換性のため、これらの変数もサポートされている: >
+	g:pyindent_open_paren
+	g:pyindent_nested_paren
+	g:pyindent_continue
+	g:pyindent_searchpair_timeout
+	g:pyindent_disable_parentheses_indenting
 
 
 R								*ft-r-indent*
@@ -1190,13 +1205,30 @@ generic/port 文の桁揃えが自動的に行われる。これによって、
 
 
 VIM							*ft-vim-indent*
+							*g:vim_indent*
+Vim script のインデントは `g:vim_indent` 辞書変数で設定できる。
+`line_continuation`、`more_in_bracket_block`、`searchpair_timeout` の 3 つの
+キーをサポートしている。
+`line_continuation` はバックスラッシュで始まる継続行のインデントレベルに追加さ
+れる数値を期待し、デフォルトは `shiftwidth() * 3` である。また、文字列も受け取
+ることができ、これは実行時に評価される。
+`more_in_bracket_block` には真偽値を指定する。オンにすると、大括弧で囲まれたブ
+ロックの中にさらに `shiftwidth()` が追加される。デフォルトは `v:false` である。
+`searchpair_timeout` はタイムアウトとして `searchpair()` に渡される数値を指定
+する。この値を大きくすると、より正確な結果が得られるかもしれないが、インデント
+に時間がかかるようになる。デフォルトは100 (ミリ秒) である。
+
+構成例: >
+
+	let g:vim_indent = #{
+	    \ line_continuation: shiftwidth() * 3,
+	    \ more_in_bracket_block: v:false,
+	    \ searchpair_timeout: 100,
+	    \ }
+<
 							*g:vim_indent_cont*
-Vim script に対しては継続行(バックスラッシュで始まる行)のインデント量を指定
-する変数が1つある: >
-
-	:let g:vim_indent_cont = shiftwidth() * 3
-
-shiftwidth の 3 倍が既定値である。
+この変数は `g:vim_indent.line_continuation` と等価である。
+後方互換性のためにサポートされている。
 
 
  vim:tw=78:ts=8:noet:ft=help:norl:

en/indent.txt

@@ -1,4 +1,4 @@
-*indent.txt*    For Vim version 9.0.  Last change: 2022 May 21
+*indent.txt*    For Vim version 9.0.  Last change: 2022 Oct 10
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -982,26 +982,42 @@ indentation: >
 
 PYTHON							*ft-python-indent*
 
-The amount of indent can be set for the following situations.  The examples
-given are the defaults.  Note that the variables are set to an expression, so
-that you can change the value of 'shiftwidth' later.
+The amount of indent can be set with the `g:python_indent` |Dictionary|, which
+needs to be created before adding the items: >
+	let g:python_indent = {}
+The examples given are the defaults.  Note that the dictionary values are set
+to an expression, so that you can change the value of 'shiftwidth' later
+without having to update these values.
 
 Indent after an open paren: >
-	let g:pyindent_open_paren = 'shiftwidth() * 2'
+	let g:python_indent.open_paren = 'shiftwidth() * 2'
 Indent after a nested paren: >
-	let g:pyindent_nested_paren = 'shiftwidth()'
+	let g:python_indent.nested_paren = 'shiftwidth()'
 Indent for a continuation line: >
-	let g:pyindent_continue = 'shiftwidth() * 2'
+	let g:python_indent.continue = 'shiftwidth() * 2'
+
+By default, the closing paren on a multiline construct lines up under the first
+non-whitespace character of the previous line.
+If you prefer that it's lined up under the first character of the line that
+starts the multiline construct, reset this key: >
+	let g:python_indent.closed_paren_align_last_line = v:false
 
 The method uses |searchpair()| to look back for unclosed parentheses.  This
 can sometimes be slow, thus it timeouts after 150 msec.  If you notice the
 indenting isn't correct, you can set a larger timeout in msec: >
-	let g:pyindent_searchpair_timeout = 500
+	let g:python_indent.searchpair_timeout = 500
 
 If looking back for unclosed parenthesis is still too slow, especially during
 a copy-paste operation, or if you don't need indenting inside multi-line
 parentheses, you can completely disable this feature: >
-	let g:pyindent_disable_parentheses_indenting = 1
+	let g:python_indent.disable_parentheses_indenting = 1
+
+For backward compatibility, these variables are also supported: >
+	g:pyindent_open_paren
+	g:pyindent_nested_paren
+	g:pyindent_continue
+	g:pyindent_searchpair_timeout
+	g:pyindent_disable_parentheses_indenting
 
 
 R								*ft-r-indent*
@@ -1214,13 +1230,31 @@ comments will be indented according to the correctly indented code.
 
 
 VIM							*ft-vim-indent*
+							*g:vim_indent*
+Vim scripts indentation can be configured with the `g:vim_indent` dictionary
+variable.  It supports 3 keys, `line_continuation`, `more_in_bracket_block`,
+and `searchpair_timeout`.
+`line_continuation` expects a number which will be added to the indent level of
+a continuation line starting with a backslash, and defaults to
+`shiftwidth() * 3` .  It also accepts a string, which is evaluated at runtime.
+`more_in_bracket_block` expects a boolean value; when on, an extra
+`shiftwidth()` is added inside blocks surrounded with brackets.  It defaults to
+`v:false`.
+`searchpair_timeout` expects a number which will be passed to `searchpair()` as
+a timeout.  Increasing the value might give more accurate results, but also
+causes the indentation to take more time.  It defaults to 100 (milliseconds).
+
+Example of configuration: >
+
+	let g:vim_indent = #{
+	    \ line_continuation: shiftwidth() * 3,
+	    \ more_in_bracket_block: v:false,
+	    \ searchpair_timeout: 100,
+	    \ }
+<
 							*g:vim_indent_cont*
-For indenting Vim scripts there is one variable that specifies the amount of
-indent for a continuation line, a line that starts with a backslash: >
-
-	:let g:vim_indent_cont = shiftwidth() * 3
-
-Three times shiftwidth is the default value.
+This variable is equivalent to `g:vim_indent.line_continuation`.
+It's supported for backward compatibility.
 
 
  vim:tw=78:ts=8:noet:ft=help:norl: