[groff] 47/127: [docs]: Add Russian language support (6/7).

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 1058ed9c474c9e0689c5c55670175236f8a3bfc5
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.
    
    * NEWS: Add item.
---
 ChangeLog            |  9 +++++++++
 NEWS                 | 17 +++++++++++++++++
 doc/groff.texi       | 20 ++++++++++++++++++++
 doc/ms.ms            |  3 ++-
 man/groff_tmac.5.man | 32 ++++++++++++++++++++++++++++++++
 5 files changed, 80 insertions(+), 1 deletion(-)

diff --git a/ChangeLog b/ChangeLog
index 6e48ae27b..d8d55f351 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/NEWS b/NEWS
index 85b034be3..caa227fa8 100644
--- a/NEWS
+++ b/NEWS
@@ -7,6 +7,23 @@
 This file describes recent user-visible changes in groff.  Bug fixes are
 not described.  There are more details in the man and info pages.
 
+VERSION next
+============
+
+Macro packages
+--------------
+o The new macro file "koi8-r.tmac" supports the KOI8-R character
+  encoding, which supports the new Russian locale for groff.
+
+Miscellaneous
+-------------
+
+o Russian language input documents using the KOI8-R encoding are now
+  supported, including hyphenation patterns from the ruhyphen project
+  and localized strings for the man, ms, me, mm, and mom packages.
+  Thanks to Nikita Ivanov.
+
+
 VERSION 1.23.0
 ==============
 
diff --git a/doc/groff.texi b/doc/groff.texi
index 2a6635e9d..c1fdff2ae 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -5527,6 +5527,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
@@ -8564,6 +8581,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
 non-zero 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
@@ -8611,6 +8629,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
 
@@ -8695,6 +8714,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 984c80424..c9046c682 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -3028,11 +3028,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