diff options
Diffstat (limited to 'doc/groff.texi')
-rw-r--r-- | doc/groff.texi | 34 |
1 files changed, 28 insertions, 6 deletions
diff --git a/doc/groff.texi b/doc/groff.texi index 7e300dbef..de83cd5d2 100644 --- a/doc/groff.texi +++ b/doc/groff.texi @@ -5499,6 +5499,23 @@ The remaining encodings require support that is not built-in to the GNU @code{troff} executable; instead, they use 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 @@ -8507,6 +8524,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 @@ -8554,6 +8572,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 @@ -8637,18 +8656,21 @@ 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 the @code{hla} request (see below). The @code{hpf} request is usually invoked by a localization file loaded by the @file{troffrc} file. By default, @file{troffrc} loads the localization file for -English.@footnote{As of @code{groff} 1.23.0, localization files for -Czech (@code{cs}), German (@code{de}), English (@code{en}), French -(@code{fr}), Italian (@code{it}), Japanese (@code{ja}), Swedish -(@code{sv}), and Chinese (@code{zh}) exist.} For Western languages, the -localization file sets the hyphenation mode and loads hyphenation -patterns and exceptions. +English.@footnote{As of @code{groff} +@c XXX 1.23.0 +1.23.0++, +localization files for Czech (@code{cs}), German (@code{de}), English +(@code{en}), French (@code{fr}), Italian (@code{it}), Japanese +(@code{ja}), Russian (@code{ru}), Swedish (@code{sv}), and Chinese +(@code{zh}) exist.} For Western languages, the localization file sets +the hyphenation mode and loads hyphenation patterns and exceptions. A second call to @code{hpf} (for the same language) replaces the hyphenation patterns with the new ones. Invoking @code{hpf} or |