[groff] 38/62: [docs]: Add Russian language support (6/7).

[G. Branden Robinson]

gbranden pushed a commit to branch branden-2023-04-20
in repository groff.

commit f395d3b3ca2a7974d3c937fc67416d4e709f9405
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
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):
      Document support for KOI8-R encoding and Russian language.
---
 ChangeLog            |  9 +++++++++
 doc/groff.texi       | 20 ++++++++++++++++++++
 doc/ms.ms            |  3 ++-
 man/groff_tmac.5.man | 32 ++++++++++++++++++++++++++++++++
 4 files changed, 63 insertions(+), 1 deletion(-)

diff --git a/ChangeLog b/ChangeLog
index c1ec55bad..9566adc8b 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2023-03-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       [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):
+       Document support for KOI8-R encoding and Russian language.
+
 2023-03-08  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        [tmac]: Add Russian language support (5/7).
diff --git a/doc/groff.texi b/doc/groff.texi
index 597188319..6e5c4cb99 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 03a13b46d..e380c28cc 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -3018,11 +3018,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_tmac.5.man b/man/groff_tmac.5.man
index df9ad639b..bc46cc539 100644
--- a/man/groff_tmac.5.man
+++ b/man/groff_tmac.5.man
@@ -395,6 +395,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
@@ -458,6 +473,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