[groff] 44/115: [docs]: Add Russian language support (6/7).

[G. Branden Robinson]

gbranden pushed a commit to branch branden-2022-06-01
in repository groff.

commit d3f2396bb49826b91c7f4310733c63678ae7e337
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 (Language and localization):
    * 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 c81d9a18a..4f8127b80 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 (Language and localization):
+       * 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 e63407330..613a5f829 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -5511,6 +5511,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 @ref{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
@@ -8548,6 +8565,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
@@ -8595,6 +8613,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
 
@@ -8679,6 +8698,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 a74310c54..578db9d83 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -3027,11 +3027,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 fac78f52f..dd4b6bdb4 100644
--- a/man/groff_tmac.5.man
+++ b/man/groff_tmac.5.man
@@ -396,6 +396,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
@@ -459,6 +474,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