Merge pull request #892 from tsuyoshicho/update/pattern-20210301

Update pattern.{txt.jax}

Author: k-takata

doc/pattern.jax

@@ -1,4 +1,4 @@
-*pattern.txt*   For Vim バージョン 8.2.  Last change: 2020 Dec 06
+*pattern.txt*   For Vim バージョン 8.2.  Last change: 2021 Jan 08
 
 
 		  VIMリファレンスマニュアル	  by Bram Moolenaar
@@ -390,15 +390,18 @@ NFA エンジンが選択され、未実装の機能が使用され、パター
 ==============================================================================
 3. Magic							*/magic*
 
-パターンの中でリテラルとして扱われる文字は、テキストの同じ文字とマッチします。
-しかし、バックスラッシュが前置されると、特別な意味を持つようになります。
+パターンの中でリテラル、つまり文字列として扱われる文字は、テキストの同じ文字と
+マッチします。しかし、バックスラッシュが前置されると、特別な意味を持つことがあ
+ります。
 
 バックスラッシュを前置しなくても特別な意味を持つ文字があります。そのような文字
 をリテラル文字としてマッチさせるには、バックスラッシュを前置する必要がありま
-す。
+す。例えば "." は任意の文字にマッチし "\." はドットにマッチします。
 
 ある文字がリテラルとして処理されるかどうかは、オプション 'magic' と、以下で説
-明するアイテムに依存します。
+明するパターンに含まれるアイテムに依存します。オプション 'magic' は常に設定す
+るべきですが、Vi 互換のためにオフにすることができます。ここでは網羅性のために
+'nomagic' の効果を説明しますが、使用については推奨しません。
 							*/\m* */\M*
 "\m" を使うと、それ以降のパターンは 'magic' がオンの状態で処理されます。
 オプション 'magic' の設定よりも優先されます。
@@ -413,23 +416,22 @@ ASCII文字は特別な意味を持ちます: "very magic"
 例:
 after:	  \v	   \m	    \M	     \V		マッチするもの ~
 		'magic' 'nomagic'
-	  $	   $	    $	     \$		行末
+	  a	   a	    a	     a		リテラルの 'a'
+	  \a	   \a	    \a	     \a		何かの英字 1 文字
 	  .	   .	    \.	     \.		何か 1 文字
+	  \.	   \.	    .	     .		リテラルのドット
+	  $	   $	    $	     \$		行末
 	  *	   *	    \*	     \*		直前のアトムの繰り返し
 	  ~	   ~	    \~	     \~		直近の置換文字列
-	  ()	   \(\)     \(\)     \(\)	グループ化してアトムにする
-	  |	   \|	    \|	     \|		選択の区切り
-	  \a	   \a	    \a	     \a		英字
+	  ()	   \(\)     \(\)     \(\)	アトムとしてグループ化
+	  |	   \|	    \|	     \|		マッチ無し: 選択の区切り
 	  \\	   \\	    \\	     \\		リテラルのバックスラッシュ
-	  \.	   \.	    .	     .		リテラルのドット
-	  \{	   {	    {	     {		リテラルの '{'
-	  a	   a	    a	     a		リテラルの 'a'
+	  \{	   {	    {	     {		リテラルの波カッコ
 
 {\m、\M、\v、\V、はVimだけの機能です}
 
-オプション 'magic' は初期設定のままにしておいてください。環境の違いによるトラ
-ブルを回避できます。パターンが 'magic' の設定に影響されないようにするには、パ
-ターンの先頭に "\m" か "\M" を置きます。
+パターンが 'magic' の設定に影響されないよう望むなら、パターンの先頭に "\m" か
+"\M" を置きます。
 
 
 ==============================================================================
@@ -1161,7 +1163,7 @@ x	特別な意味のない文字は、その文字自身とマッチします
 		\b	<BS>
 		\n	改行。|/[\n]| 参照。
 		\d123	10進数の文字番号
-		\o40	8 進数の文字番号 (最大値 0377)
+		\o40	8 進数の文字番号 (最大値 0o377)
 		\x20	16進数の文字番号 (最大値 0xff)
 		\u20AC	16進数のマルチバイト文字番号 (最大値 0xffff)
 		\U1234	16進数のマルチバイト文字番号 (最大値 0xffffffff)
@@ -1198,9 +1200,9 @@ x	特別な意味のない文字は、その文字自身とマッチします
 
 \%d123	10進数で指定した文字にマッチします。このアトムの後ろには数字以外の文字
 	を置いてください。
-\%o40	8 進数で指定した文字にマッチします (最大値 0377)。040 より小さい値を指
-	定するとき、このアトムの後ろには8進数字以外の文字か、数字以外の文字を
-	置いてください。
+\%o40	8 進数で指定した文字にマッチします (最大値 0377)。0o40 より小さい値を
+	指定するとき、このアトムの後ろには8進数字以外の文字か、数字以外の文字
+	を置いてください。
 \%x2a	16進数で指定した文字にマッチします。2桁まで。
 \%u20AC	16進数で指定した文字にマッチします。4桁まで。
 \%U1234abcd	16進数で指定した文字にマッチします。8桁まで。0x7fffffff まで。

en/pattern.txt

@@ -1,4 +1,4 @@
-*pattern.txt*   For Vim version 8.2.  Last change: 2020 Dec 06
+*pattern.txt*   For Vim version 8.2.  Last change: 2021 Jan 08
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -394,15 +394,19 @@ the pattern will not match.  This is only useful when debugging Vim.
 ==============================================================================
 3. Magic							*/magic*
 
-Some characters in the pattern are taken literally.  They match with the same
-character in the text.  When preceded with a backslash however, these
-characters get a special meaning.
+Some characters in the pattern, such as letters, are taken literally.  They
+match exactly the same character in the text.  When preceded with a backslash
+however, these characters may get a special meaning.  For example, "a" matches
+the letter "a", while "\a" matches any alphabetic character.
 
 Other characters have a special meaning without a backslash.  They need to be
-preceded with a backslash to match literally.
+preceded with a backslash to match literally.  For example "." matches any
+character while "\." matches a dot.
 
 If a character is taken literally or not depends on the 'magic' option and the
-items mentioned next.
+items in the pattern mentioned next.  The 'magic' option should always be set,
+but it can be switched off for Vi compatibility.  We mention the effect of
+'nomagic' here for completeness, but we recommend against using that.
 							*/\m* */\M*
 Use of "\m" makes the pattern after it be interpreted as if 'magic' is set,
 ignoring the actual value of the 'magic' option.
@@ -411,30 +415,28 @@ Use of "\M" makes the pattern after it be interpreted as if 'nomagic' is used.
 Use of "\v" means that after it, all ASCII characters except '0'-'9', 'a'-'z',
 'A'-'Z' and '_' have special meaning: "very magic"
 
-Use of "\V" means that after it, only a backslash and terminating character
-(usually / or ?) have special meaning: "very nomagic"
+Use of "\V" means that after it, only a backslash and the terminating
+character (usually / or ?) have special meaning: "very nomagic"
 
 Examples:
 after:	  \v	   \m	    \M	     \V		matches ~
 		'magic' 'nomagic'
-	  $	   $	    $	     \$		matches end-of-line
-	  .	   .	    \.	     \.		matches any character
+	  a	   a	    a	     a		literal 'a'
+	  \a	   \a	    \a	     \a		any alphabetic character
+	  .	   .	    \.	     \.		any character
+	  \.	   \.	    .	     .		literal dot
+	  $	   $	    $	     \$		end-of-line
 	  *	   *	    \*	     \*		any number of the previous atom
 	  ~	   ~	    \~	     \~		latest substitute string
-	  ()	   \(\)     \(\)     \(\)	grouping into an atom
-	  |	   \|	    \|	     \|		separating alternatives
-	  \a	   \a	    \a	     \a		alphabetic character
+	  ()	   \(\)     \(\)     \(\)	group as an atom
+	  |	   \|	    \|	     \|		nothing: separates alternatives
 	  \\	   \\	    \\	     \\		literal backslash
-	  \.	   \.	    .	     .		literal dot
-	  \{	   {	    {	     {		literal '{'
-	  a	   a	    a	     a		literal 'a'
+	  \{	   {	    {	     {		literal curly brace
 
 {only Vim supports \m, \M, \v and \V}
 
-It is recommended to always keep the 'magic' option at the default setting,
-which is 'magic'.  This avoids portability problems.  To make a pattern immune
-to the 'magic' option being set or not, put "\m" or "\M" at the start of the
-pattern.
+If you want to you can make a pattern immune to the 'magic' option being set
+or not by putting "\m" or "\M" at the start of the pattern.
 
 ==============================================================================
 4. Overview of pattern items				*pattern-overview*
@@ -1177,7 +1179,7 @@ x	A single character, with no special meaning, matches itself
 		\b	<BS>
 		\n	line break, see above |/[\n]|
 		\d123	decimal number of character
-		\o40	octal number of character up to 0377
+		\o40	octal number of character up to 0o377
 		\x20	hexadecimal number of character up to 0xff
 		\u20AC	hex. number of multibyte character up to 0xffff
 		\U1234	hex. number of multibyte character up to 0xffffffff
@@ -1215,7 +1217,8 @@ x	A single character, with no special meaning, matches itself
 \%d123	Matches the character specified with a decimal number.  Must be
 	followed by a non-digit.
 \%o40	Matches the character specified with an octal number up to 0377.
-	Numbers below 040 must be followed by a non-octal digit or a non-digit.
+	Numbers below 0o40 must be followed by a non-octal digit or a
+	non-digit.
 \%x2a	Matches the character specified with up to two hexadecimal characters.
 \%u20AC	Matches the character specified with up to four hexadecimal
 	characters.