Merge pull request #2474 from h-east/update-syntax

Update syntax.{txt,jax}

Author: h-east

doc/syntax.jax

@@ -1,4 +1,4 @@
-*syntax.txt*	For Vim バージョン 9.1.  Last change: 2026 Jan 06
+*syntax.txt*	For Vim バージョン 9.1.  Last change: 2026 Jan 23
 
 
 		  VIM リファレンスマニュアル    by Bram Moolenaar
@@ -2630,47 +2630,51 @@ ncf.vimによって認識されない文をエラーとしてハイライトさ
 
 NROFF						*nroff.vim* *ft-nroff-syntax*
 
-nroff構文ファイルはそのままでAT&T n/troffに対応している。構文ファイルに含まれ
-ているGNU groff拡張機能を使うには、それを有効化する必要がある。
-
-例えば、LinuxとBSDディストリビューションは、デフォルトではテキスト処理パッケー
-ジとしてgroffを使う。groff用の拡張構文ハイライト機能を有効化するには、ファイル
-を groff (|ft-groff-syntax| を参照)として認識されるように調整する、あるいは次
-のオプションを初期化ファイルに加える: >
+nroff 構文ファイルは、AT&T n/troff でそのまま使用できる。Linux および BSD ディ
+ストリビューションがデフォルトの組版パッケージとして使用している GNU troff
+(groff) をサポートするには、ファイルを groff の入力として認識させるか
+(|ft-groff-syntax| を参照)、スタートアップファイルに以下のオプションを追加す
+る: >
 
   :let nroff_is_groff = 1
 
-groffは、Solarisでまだ使われているかもしれない古いAT&T n/troffとは異なる。
-groffのマクロとリクエスト名は2文字以上の長さであってもよく、言語プリミティブに
-拡張がされている。例えば、AT&T troffではリクエスト\(yrを使い、2桁の数で年にア
-クセスする。groffでは互換性のために同じリクエストを使うこともできるし、または
-groffネイティブの構文,\[yr]を使うこともできる。さらに、\[year]として4桁の年を
-直接使うこともできる。マクロリクエストは2文字以上の長さであってもよい。例えば、
-GNU mmはverbatim環境を作るのに ".VERBON" と ".VERBOFF" というリクエストを受け
-つける。
+GNU troff は、*roff 言語構文を拡張することで、古い AT&T n/troff プログラム
+(Solaris や Plan 9 にまだ残っているかもしれない) とは異なる。例えば、AT&T
+troff では、1900 年からの年数にはエスケープシーケンス \(yr でアクセスする。
+groff でも同様にエスケープシーケンス \(yr を使用してアクセスでき、互換性のため
+に認識される。あるいは、groff の拡張構文 \[yr] を使用できる。AT&T troff では、
+yr レジスタは "現在の年の下 2 桁" を格納すると説明されていたが、Y2K 問題があっ
+た。groff では、\[year] でグレゴリオ暦の年を正しくアクセスできる。groff では、
+フォント名、レジスタ名、マクロ名、文字列名、リクエスト名は 2 文字を超えること
+ができる。例えば、groff の mm パッケージでは、制御行 ".VERBON" と".VERBOFF"
+は、これらの名前のマクロを呼び出して、"verbatim" な内容の表示を囲む。
 
 g/troffによって得られる最良の整形された出力を得るには、スペースと句読点に関す
 るいくつかの単純なルールに従うべきである。
 
-1. 行の末尾に空のスペースを置かないこと
-
-2. 文末のピリオド、エクスクラメーションマークなどの後にはちょうど1個のスペース
-   を置くこと。
+1. 各文の末尾で改行 (キャリッジリターン) すること。改行の前にスペースを入れな
+   いこと。
 
-3. 後述の理由により、全てのピリオドの後に改行(carriage return)を置くとよい。
+2. 行末にピリオド、疑問符、感嘆符があり、それらが文の終わりを意味しない場合は、
+   ダミー文字のエスケープシーケンス \& を続けて使用すること。
 
-これらの妙なtipsの理由は、g/n/troffが改行に、これらのルールに従わないとすぐに
-混乱してしまうアルゴリズムを使っているためである。
+3. マクロパッケージを使用している場合は、段落分けマクロを使用して段落のインデ
+   ントと段落間のスペースを確保すること。
 
+4. 文書の保守を容易にするため、空リクエスト (行に '.' のみ) を自由に使用して、
+   視覚的に要素を区切ること。
 
-troffはTeXと違い、段落ごとでなく行ごとにテキストを書き込む。さらに、glueや
-stretchの概念を持たず、入力に水平、垂直の空白があると全てそのまま出力される。
+これらのヒントの理由は、g/n/troff が文末を検出し、その情報を用いて文間スペース
+を適用できるためである。また、これらのヒントを使用すると、テキストエディタでの
+再入力によってのみ行が変更される diff のサイズも最小限に抑えられる。マクロパッ
+ケージは通常、段落間のスペースとして 1 つの V 字 (入力行が空白の場合に発生する)
+以外の値を使用し、そのスペース値と段落のインデントをユーザーが設定可能なレジス
+タに保存することで、ページのレイアウトを一定に保つ。
 
-それゆえ、最終的なドキュメントで意図する以上の空白を文と文の間にはさまないよう
-に注意すること。この理由のため、全ての句読点記号の後すぐに改行を入れるという習
-慣がある。最終的に処理された出力が「一様な」テキストになってほしければ、入力の
-テキストで正しくスペースを置いておく必要がある。行末の空白と句読点の後の2個以
-上の空白をエラーとしてハイライトしたいならこうする: >
+TeX とは異なり、troff は段落ごとではなく行ごとにテキストを埋め込む。フォーマッ
+トされた出力で単語間および文間のスペースを一定に保ちたい場合は、入力テキストの
+スペースも一定に保つ必要がある。末尾のスペースと句読点の後の 2 つ以上のスペー
+スの両方をエラーとしてマークするには、以下のようにする: >
 
   :let nroff_space_errors = 1
 
@@ -2687,11 +2691,11 @@ stretchの概念を持たず、入力に水平、垂直の空白があると全
 
 	let b:preprocs_as_sections = 1
 
-同様に、構文ファイルはmsパッケージ中の拡張段落マクロ(.XP)用の余分な段落マーカー
-も含んでいる。
+さらに、この構文ファイルは、ms パッケージの XP 段落マクロ (Berkeley および GNU
+の拡張機能) 用の段落マーカーを追加する。
 
-最後に、構文ファイル|groff.vim|が存在する。これはデフォルトでfile basisとグ
-ローバルの両方でgroff構文ハイライトすることができる。
+最後に、groff 構文のハイライトをファイルごとに、またはデフォルトでグローバルに
+有効にするために使用できる |groff.vim| 構文ファイルがある。
 
 
 OCAML						*ocaml.vim* *ft-ocaml-syntax*

en/syntax.txt

@@ -1,4 +1,4 @@
-*syntax.txt*	For Vim version 9.1.  Last change: 2026 Jan 06
+*syntax.txt*	For Vim version 9.1.  Last change: 2026 Jan 23
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -2702,50 +2702,50 @@ If you don't want to highlight these errors, leave it unset.
 
 NROFF						*nroff.vim* *ft-nroff-syntax*
 
-The nroff syntax file works with AT&T n/troff out of the box.  You need to
-activate the GNU groff extra features included in the syntax file before you
-can use them.
-
-For example, Linux and BSD distributions use groff as their default text
-processing package.  In order to activate the extra syntax highlighting
-features for groff, arrange for files to be recognized as groff (see
+The nroff syntax file works with AT&T n/troff as-is.  To support GNU troff
+(groff), which Linux and BSD distributions use as their default typesetting
+package, arrange for files to be recognized as groff input (see
 |ft-groff-syntax|) or add the following option to your start-up files: >
 
   :let nroff_is_groff = 1
 
-Groff is different from the old AT&T n/troff that you may still find in
-Solaris.  Groff macro and request names can be longer than 2 characters and
-there are extensions to the language primitives.  For example, in AT&T troff
-you access the year as a 2-digit number with the request \(yr.  In groff you
-can use the same request, recognized for compatibility, or you can use groff's
-native syntax, \[yr].  Furthermore, you can use a 4-digit year directly:
-\[year].  Macro requests can be longer than 2 characters, for example, GNU mm
-accepts the requests ".VERBON" and ".VERBOFF" for creating verbatim
-environments.
+GNU troff differs from older AT&T n/troff programs (that you may still find in
+Solaris or Plan 9) by extending the *roff language syntax.  For example, in
+AT&T troff, you access the count of years since 1900 with the escape sequence
+\(yr.  In groff you can do the same, which it recognizes for compatibility, or
+use groff's extended syntax, \[yr].  AT&T troff documented the yr register as
+storing the "last two digits of current year", but had a Y2K problem; in
+groff, you can access the Gregorian year correctly: \[year].  In groff, font,
+register, macro, string, and request names can exceed two characters; for
+example, with groff's mm package, the control lines ".VERBON" and ".VERBOFF"
+call macros of those names to bracket displays of "verbatim" content.
 
 In order to obtain the best formatted output g/troff can give you, you should
 follow a few simple rules about spacing and punctuation.
 
-1. Do not leave empty spaces at the end of lines.
+1. Break the line (put a carriage return) at the end of every sentence.  Don't
+   permit trailing spaces before the newline.
 
-2. Leave one space and one space only after an end-of-sentence period,
-   exclamation mark, etc.
+2. If a line ends with a period, question mark, or exclamation point that does
+   not end a sentence, follow it with the dummy character escape sequence \&.
 
-3. For reasons stated below, it is best to follow all period marks with a
-   carriage return.
+3. If you're using a macro package, employ its paragraphing macros to achieve
+   indentation of paragraphs and spacing between them.
 
-The reason behind these unusual tips is that g/n/troff have a line breaking
-algorithm that can be easily upset if you don't follow the rules given above.
+4. Use the empty request, a '.' on a line by itself, freely to visually
+   separate material for ease of document maintenance.
 
-Unlike TeX, troff fills text line-by-line, not paragraph-by-paragraph and,
-furthermore, it does not have a concept of glue or stretch, all horizontal and
-vertical space input will be output as is.
+The reason for these tips is that g/n/troff attempts to detect the ends of
+sentences, and can use that information to apply inter-sentence space.  Using
+them also minimizes the size of diffs where lines change due only to refilling
+in the text editor.  Macro packages typically employ inter-paragraph spacing
+amounts other than one vee (which is the result of a blank input line), and
+typically store that spacing amount, and that of paragraph indentation, in
+user-configurable registers so that pages lay out consistently.
 
-Therefore, you should be careful about not using more space between sentences
-than you intend to have in your final document.  For this reason, the common
-practice is to insert a carriage return immediately after all punctuation
-marks.  If you want to have "even" text in your final processed output, you
-need to maintain regular spacing in the input text.  To mark both trailing
+Unlike TeX, troff fills text line-by-line, not paragraph-by-paragraph.  If you
+desire consistent spacing between words and sentences in formatted output, you
+must maintain consistent spacing in the input text.  To mark both trailing
 spaces and two or more spaces after a punctuation as an error, use: >
 
   :let nroff_space_errors = 1
@@ -2765,11 +2765,11 @@ file: >
 
 	let b:preprocs_as_sections = 1
 
-As well, the syntax file adds an extra paragraph marker for the extended
-paragraph macro (.XP) in the ms package.
+Further, the syntax file adds an extra paragraph marker for the XP
+paragraphing macro in the ms package, a Berkeley and GNU extension.
 
-Finally, there is a |groff.vim| syntax file that can be used for enabling
-groff syntax highlighting either on a file basis or globally by default.
+Finally, there is a |groff.vim| syntax file that can be used to enable groff
+syntax highlighting either on a per-file basis or globally by default.
 
 
 OCAML						*ocaml.vim* *ft-ocaml-syntax*
@@ -4699,7 +4699,7 @@ the region, but not the contents of the region, are marked as concealable.
 Whether or not they are actually concealed depends on the setting on the
 'conceallevel' option.  The ends of a region can only be concealed separately
 in this way when they have their own highlighting via "matchgroup".  The
-|synconcealed()| function can be used to retrieve information about conealed
+|synconcealed()| function can be used to retrieve information about concealed
 items.
 
 cchar							*:syn-cchar*