gbranden pushed a commit to branch branden-post-1.23.0 in repository groff.
commit c5939bf72884355c244677b7aa4fb28a2a915ea8 Author: G. Branden Robinson <[email protected]> AuthorDate: Wed Mar 8 05:04:42 2023 -0600 [docs]: Add Russian language support (6/7). * doc/groff.texi (Input Encodings, Manipulating Hyphenation): * doc/ms.ms: * man/groff_tmac.5.man (Localization packages, Input encodings): * man/groff.7.man (Localization): Document support for KOI8-R encoding and Russian language. --- ChangeLog | 10 ++++++++++ doc/groff.texi | 20 ++++++++++++++++++++ doc/ms.ms | 3 ++- man/groff.7.man | 2 ++ man/groff_tmac.5.man | 32 ++++++++++++++++++++++++++++++++ 5 files changed, 66 insertions(+), 1 deletion(-) diff --git a/ChangeLog b/ChangeLog index aa98db61d..5279a8306 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,13 @@ +2023-03-08 G. Branden Robinson <[email protected]> + + [docs]: Add Russian language support (6/7). + + * doc/groff.texi (Input Encodings, Manipulating Hyphenation): + * doc/ms.ms: + * man/groff_tmac.5.man (Localization packages, Input encodings): + * man/groff.7.man (Localization): Document support for KOI8-R + encoding and Russian language. + 2023-03-08 G. Branden Robinson <[email protected]> [tmac]: Add Russian language support (5/7). diff --git a/doc/groff.texi b/doc/groff.texi index 2fd07e79f..aece67e1a 100644 --- a/doc/groff.texi +++ b/doc/groff.texi @@ -5503,6 +5503,23 @@ page writers; see the @cite{groff_char@r{(7)}} man page.} Other encodings are supported by means of macro packages. @table @code +@item koi8-r +@cindex encoding, input, @w{KOI8-R} +@cindex @w{KOI8-R}, input encoding +@cindex input encoding, @w{KOI8-R} +@pindex koi8-r.tmac +To use @w{KOI8-R}, an encoding for the Russian language, either place +@w{@samp{.mso koi8-r.tmac}} at the very beginning of your document or +supply @samp{-mkoi8-r} as a command-line argument to @code{groff}. The +localization file @file{ru.tmac} takes care of this automatically; see +@ref{Manipulating Hyphenation}.@footnote{KOI8-R code points in the range +@code{0x80}--@code{0x9F} are not valid input on systems using ISO +character codings natively; see @code{Identifiers}. This should be no +impediment to practical documents, as these KOI8-R code points do not +encode letters, but box-drawing symbols and characters that are better +obtained via special character escape sequences; see the +@cite{groff_char@r{(7)}} man page.} + @item latin2 @cindex encoding, input, @w{Latin-2} (ISO @w{8859-2}) @cindex @w{Latin-2} (ISO @w{8859-2}), input encoding @@ -8511,6 +8528,7 @@ together because they contradict; for instance, values 4 and@tie{}16, and values 8 and@tie{}32. As noted, it is superfluous to add 1 to any nonzero even mode. +@c TODO: Add @pindex for hyphenation pattern and exception files. @cindex hyphenation pattern files @cindex pattern files, for hyphenation The automatic placement of hyphens in words is determined by @@ -8558,6 +8576,7 @@ the @cite{groff_tmac@r{(5)}} man page for more information on GNU @item German traditional @tab det @tab 2 @tab 2 @item German reformed @tab den @tab 2 @tab 2 @item Italian @tab it @tab 2 @tab 2 +@item Russian @tab ru @tab 2 @tab 2 @item Swedish @tab sv @tab 1 @tab 2 @end multitable @@ -8641,6 +8660,7 @@ be used. By default, every code maps to itself except those for letters @pindex fr.tmac @pindex it.tmac @pindex ja.tmac +@pindex ru.tmac @pindex sv.tmac @pindex zh.tmac The set of hyphenation patterns is associated with the language set by diff --git a/doc/ms.ms b/doc/ms.ms index a3573e6b4..e532f7356 100644 --- a/doc/ms.ms +++ b/doc/ms.ms @@ -3006,11 +3006,12 @@ provides several strings that you can customize for your own purposes, or redefine to adapt the macro package to languages other than English. . It is already localized for -.\" cs, de, fr, it, sv +.\" cs, de, fr, it, ru, sv Czech, German, French, Italian, +Russian, and Swedish. . diff --git a/man/groff.7.man b/man/groff.7.man index 6a73814ea..0b7e907e9 100644 --- a/man/groff.7.man +++ b/man/groff.7.man @@ -6378,6 +6378,8 @@ Italian .RI ( it ), Japanese .RI ( ja ), +Russian +.RI ( ru ), Swedish .RI ( sv ), and Chinese diff --git a/man/groff_tmac.5.man b/man/groff_tmac.5.man index 8a03edbf8..2538839b8 100644 --- a/man/groff_tmac.5.man +++ b/man/groff_tmac.5.man @@ -407,6 +407,21 @@ Japanese. . . .TP +.I ru +Russian; +localizes +.IR man , +.IR me , +.IR mm , +.IR mom , +and +.IR ms . +. +Sets the input encoding to KOI8-R by loading +.IR koi8-r.tmac . +. +. +.TP .I sv Swedish; localizes @@ -470,6 +485,23 @@ loads automatically at startup. . . +.TP +.I koi8\-r +provides support for the KOI8-R encoding. +. +KOI8-R code points in the range 0x80\[en]0x9F are not valid input on +systems using ISO character codings natively; +see section \[lq]Identifiers\[rq] in +.MR groff @MAN7EXT@ . +. +This should be no impediment to practical documents, +as these KOI8-R code points do not encode letters, +but box-drawing symbols and characters that are better obtained via +special character escape sequences; +see +.MR groff_char @MAN7EXT@ . +. +. .P Because different input character codes constitute valid GNU .I troff \" GNU _______________________________________________ Groff-commit mailing list [email protected] https://lists.gnu.org/mailman/listinfo/groff-commit
