From 1ac3565dc6d61eee775768972e407aed5bea42e5 Mon Sep 17 00:00:00 2001
From: "Andrey A. Chernov" <ache@FreeBSD.org>
Date: Fri, 2 May 1997 08:37:48 +0000
Subject: [PATCH] More formatting + more info

---
 handbook/russian.sgml | 43 ++++++++++++++++++++++++-------------------
 1 file changed, 24 insertions(+), 19 deletions(-)

diff --git a/handbook/russian.sgml b/handbook/russian.sgml
index 774867773e..3b7eeb6525 100644
--- a/handbook/russian.sgml
+++ b/handbook/russian.sgml
@@ -1,14 +1,17 @@
-<!-- $Id: russian.sgml,v 1.3 1997-05-02 08:07:35 ache Exp $ -->
+<!-- $Id: russian.sgml,v 1.4 1997-05-02 08:37:48 ache Exp $ -->
 <!-- The FreeBSD Documentation Project -->
 
-<sect><heading>Russian Language<label id="russian"></heading>
+<sect><heading>Russian Language (KOI8-R encoding)<label id="russian"></heading>
 <p><em>Contributed by &a.ache;<newline>
 1 May 1997</em>.
+<p>See more info about KOI8-R encoding at
+<htmlurl url="http://www.nagual.pp.ru/~ache/koi8.html"
+name="KOI8-R References (Russian Net Character Set)">.
 
 <sect1><heading>Console Setup<label id="russian:console"></heading>
 <p>
 <enum>
-<item> Russian console entry in <tt>/etc/rc.conf</tt> should looks like
+<item>Russian console entry in <tt>/etc/rc.conf</tt> should looks like
 <verb>
 keymap=ru.koi8-r
 keychange="61 ^[[K"
@@ -22,8 +25,8 @@ font8x8=cp866-8x8
 <tt>/etc/rc.conf</tt>,
 not just ^[ string.
 <p>
-This tuning means koi8-r keyboard with Alternative
-screen font mapped to koi8-r character set to
+This tuning means KOI8-R keyboard with Alternative
+screen font mapped to KOI8-R encoding to
 preserve pseudographics, <it>Gray Delete</it> key remapped to match Russian
 <tt>termcap(5)</tt> entry for FreeBSD console.
 <p>
@@ -31,7 +34,7 @@ RUS/LAT switch will be <bf>CapsLock</bf>. Old CapsLock function still
 available via <bf>Shift+CapsLock</bf>. CapsLock LED will
 indicate RUS mode, not CapsLock mode.
 
-<item> For each <tt>ttyv?</tt> entry in <tt>/etc/ttys</tt>
+<item>For each <tt>ttyv?</tt> entry in <tt>/etc/ttys</tt>
 change terminal type from <tt>cons25</tt> to
 <tt>cons25r</tt>, i.e. each entry should looks like
 <verb>
@@ -43,9 +46,10 @@ ttyv0	"/usr/libexec/getty Pc"		cons25r	on  secure
 <p><label id="russian:env">
 There is two environment variables for locale setup:
 <itemize>
-<item> <tt>LANG</tt>
+<item><tt>LANG</tt>
 for POSIX <tt>setlocale(3)</tt> family functions;
-<item> <tt>MM_CHARSET</tt> for applications MIME chararter set.
+<item><tt>MM_CHARSET</tt>
+for applications MIME chararter set.
 </itemize>
 <p>
 The best way is using <tt>/etc/login.conf</tt>
@@ -77,7 +81,7 @@ user:password:1111:11:russian:0:0:User Name:/home/user:/bin/csh
 <p>
 If you use <tt>adduser(8)</tt> for adding new users:
 <itemize>
-<item> Set
+<item>Set
 <verb>
 defaultclass = russian
 </verb>
@@ -86,7 +90,7 @@ in <tt>/etc/adduser.conf</tt>
 users in this case);
 <newline><newline>
 
-<item> Alternative variant will be answering <tt>russian</tt>
+<item>Alternative variant will be answering <tt>russian</tt>
 each time when you see
 <verb>
 Enter login class: default []:
@@ -94,7 +98,7 @@ Enter login class: default []:
 prompt from <tt>adduser(8)</tt>;
 <newline><newline>
 
-<item> Another variant: call
+<item>Another variant: call
 <verb>
 # adduser -class russian
 </verb>
@@ -117,13 +121,13 @@ this
 <ref id="russian:env" name="two environment variables">
 in the following shell startup files:
 <itemize>
-<item> <tt>/etc/profile</tt>:
+<item><tt>/etc/profile</tt>:
 <verb>
 LANG=ru_RU.KOI8-R; export LANG
 MM_CHARSET=KOI8-R; export MM_CHARSET
 </verb>
 
-<item> <tt>/etc/csh.login</tt>:
+<item><tt>/etc/csh.login</tt>:
 <verb>
 setenv LANG ru_RU.KOI8-R
 setenv MM_CHARSET KOI8-R
@@ -132,20 +136,21 @@ setenv MM_CHARSET KOI8-R
 <p>
 Alternatively you can add this instructions to
 <itemize>
-<item> <tt>/usr/share/skel/dot.profile</tt>:
+<item><tt>/usr/share/skel/dot.profile</tt>:
 <p>
 (similar to <tt>/etc/profile</tt> above);
 
-<item> <tt>/usr/share/skel/dot.login</tt>:
+<item><tt>/usr/share/skel/dot.login</tt>:
 <p>
 (similar to <tt>/etc/csh.login</tt> above).
 </itemize>
 
 <sect1><heading>X Window Setup<label id="russian:xwindow"></heading>
 <p>
+Step by step instructions:
 <enum>
-<item> First off all do
-<ref id="russian:locale" name="locale setup"> as described.
+<item>Do
+<ref id="russian:locale" name="locale setup"> first as described.
 <p>
 <it>NOTE:</it><label id="russian:note">
 Russian KOI8-R locale may not work with old XFree86 versions
@@ -156,7 +161,7 @@ from this port.
 Basically, XFree86 version shipped with latest FreeBSD distribution should
 work too unless somebody forget to apply port patches to it.
 
-<item> Go to <tt>/usr/ports/russian/X.language</tt> directory and say
+<item>Go to <tt>/usr/ports/russian/X.language</tt> directory and say
 <verb>
 # make all install
 </verb>
@@ -173,7 +178,7 @@ following lines must be before any other <tt>FontPath</tt> entries:
 If you use high resolution video mode, swap 75 dpi and
 100 dpi lines.
 
-<item> To activate Russian keyboard add
+<item>To activate Russian keyboard add
 <verb>
     XkbKeymap   "xfree86(ru)"
 </verb>