Improve SGML formatting.

Add more info.

1 files changed, 92 insertions, 61 deletions

diff --git a/share/doc/handbook/russian.sgml b/share/doc/handbook/russian.sgml
index 88036d7..9c4058e 100644
--- a/share/doc/handbook/russian.sgml
+++ b/share/doc/handbook/russian.sgml
@@ -1,4 +1,4 @@
-<!-- $Id: russian.sgml,v 1.1 1997/05/02 02:20:25 ache Exp $ -->
+<!-- $Id: russian.sgml,v 1.2 1997/05/02 04:55:14 ache Exp $ -->
 <!-- The FreeBSD Documentation Project -->
 
 <sect><heading>Russian Language<label id="russian"></heading>
@@ -7,153 +7,184 @@
 
 <sect1><heading>Console Setup<label id="russian:console"></heading>
 <p>
-Russian console entry in <tt>/etc/rc.conf</tt> should looks like
-<tscreen><verb>
+<enum>
+<item> Russian console entry in <tt>/etc/rc.conf</tt> should looks like
+<verb>
 keymap=ru.koi8-r
 keychange="61 ^[[K"
 scrnmap=koi8-r2cp866
 font8x16=cp866b-8x16
 font8x14=cp866-8x14
 font8x8=cp866-8x8
-</verb></tscreen>
+</verb>
 <p>
-NOTE: ^[ means that real ESC character must be entered into
+<it>NOTE:</it> ^[ means that real ESC character must be entered into
 <tt>/etc/rc.conf</tt>,
 not just ^[ string.
 <p>
-This tuning means koi8-r keyboard with Alternative codeset
+This tuning means koi8-r keyboard with Alternative
 screen font mapped to koi8-r character set to
 preserve pseudographics, <it>Gray Delete</it> key remapped to match Russian
-termcap entry for console.
-See <tt>rc.conf(5)</tt> for details.
+<tt>termcap(5)</tt> entry for FreeBSD console.
 <p>
-RUS/LAT switch will be <it>CapsLock</it>.
-<p>
-For each <tt>ttyv?</tt> entry in <tt>/etc/ttys</tt>
-change terminal type from <bf>cons25</bf> to
-<bf>cons25r</bf>, i.e. each entry should looks like
-<tscreen><verb>
+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>
+change terminal type from <tt>cons25</tt> to
+<tt>cons25r</tt>, i.e. each entry should looks like
+<verb>
 ttyv0	"/usr/libexec/getty Pc"		cons25r	on  secure
-</verb></tscreen>
+</verb>
+</enum>
 
 <sect1><heading>Locale Setup<label id="russian:locale"></heading>
+<p><label id="russian:env">
+There is two environment variables for locale setup:
+<itemize>
+<item> <tt>LANG</tt>
+for POSIX <tt>setlocale(3)</tt> family functions;
+<item> <tt>MM_CHARSET</tt> for applications MIME chararter set.
+</itemize>
 <p>
-There is two environment variables for locale setup: <tt>LANG</tt>
-and <tt>MM_CHARSET</tt>.
 The best way is using <tt>/etc/login.conf</tt>
-<bf>russian</bf> user's login class
+<tt>russian</tt> user's login class
 in <tt>passwd(5)</tt> entry login class position.
 See <tt>login.conf(5)</tt> for details.
+
 <sect2><heading>Login Class Method<label id="russian:class"></heading>
 <p>
-As first step check your <tt>/etc/login.conf</tt> have
-<bf>russian</bf> login class, this entry may looks like:
-<tscreen><verb>
+First of all check your <tt>/etc/login.conf</tt> have
+<tt>russian</tt> login class, this entry may looks like:
+<verb>
 russian:Russian Users Accounts:\
 	:charset=KOI8-R:\
 	:lang=ru_RU.KOI8-R:\
 	:tc=default:
-</verb></tscreen>
+</verb>
 
 <sect3><heading>How to do it with vipw(8)</heading>
 <p>
 If you use <tt>vipw(8)</tt> for adding new users,
 <tt>/etc/master.passwd</tt>
 entry should looks like:
-<tscreen><verb>
+<verb>
 user:password:1111:11:russian:0:0:User Name:/home/user:/bin/csh
-</verb></tscreen>
+</verb>
 
 <sect3><heading>How to do it with adduser(8)</heading>
 <p>
-If you use <tt>adduser(8)</tt> for adding new users, set
-<tscreen><verb>
+If you use <tt>adduser(8)</tt> for adding new users:
+<itemize>
+<item> Set
+<verb>
 defaultclass = russian
-</verb></tscreen>
+</verb>
 in <tt>/etc/adduser.conf</tt>
-(you must enter <bf>default</bf> class for all non-Russian
-users in this case).
-<p>
-Alternative variant will be answer <bf>russian</bf> each time when you see
-<tscreen><verb>
+(you must enter <tt>default</tt> class for all non-Russian
+users in this case);
+<newline><newline>
+
+<item> Alternative variant will be answering <tt>russian</tt>
+each time when you see
+<verb>
 Enter login class: default []:
-</verb></tscreen>
-prompt from <tt>adduser(8)</tt>, or call
-<tscreen><verb>
+</verb>
+prompt from <tt>adduser(8)</tt>;
+<newline><newline>
+
+<item> Another variant: call
+<verb>
 # adduser -class russian
-</verb></tscreen>
+</verb>
 for each Russian user you want to add.
+</itemize>
 
 <sect3><heading>How to do it with pw(8)</heading>
 <p>
 If you use <tt>pw(8)</tt> for adding new users, call it in this form:
-<tscreen><verb>
+<verb>
 # pw useradd user_name -L russian
-</verb></tscreen>
+</verb>
 
 <sect2><heading>Shell Startup Files Method</heading>
 <p>
 If you don't want to use
 <ref id="russian:class" name="login class method">
 for some reasons, just set
-this two environment variables in <tt>/etc/profile</tt>:
-<tscreen><verb>
+this
+<ref id="russian:env" name="two environment variables">
+in the following shell startup files:
+<itemize>
+<item> <tt>/etc/profile</tt>:
+<verb>
 LANG=ru_RU.KOI8-R; export LANG
 MM_CHARSET=KOI8-R; export MM_CHARSET
-</verb></tscreen>
-and <tt>/etc/csh.login</tt>:
-<tscreen><verb>
+</verb>
+
+<item> <tt>/etc/csh.login</tt>:
+<verb>
 setenv LANG ru_RU.KOI8-R
 setenv MM_CHARSET KOI8-R
-</verb></tscreen>
+</verb>
+</itemize>
 <p>
 Alternatively you can add this instructions to
-<tt>/usr/share/skel/dot.profile</tt>
-(similar to <tt>/etc/profile</tt>) and
-<tt>/usr/share/skel/dot.login</tt> (similar to
-<tt>/etc/csh.login</tt>).
+<itemize>
+<item> <tt>/usr/share/skel/dot.profile</tt>:
+<p>
+(similar to <tt>/etc/profile</tt> above);
+
+<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>
-First off all do
+<enum>
+<item> First off all do
 <ref id="russian:locale" name="locale setup"> as described.
 <p>
 <it>NOTE:</it><label id="russian:note">
 Russian KOI8-R locale may not work with old XFree86 versions
-(lower than 3.2.1 + patches).
+(lower than 3.2.1 + locale/keyboard patches).
 XFree86 port from <tt>/usr/ports/x11/XFree86</tt> already have
 all neccessary patches, so it will work, if you install XFree86
 from this port.
 Basically, XFree86 version shipped with latest FreeBSD distribution should
 work too unless somebody forget to apply port patches to it.
-<p>
-Then go to <tt>/usr/ports/russian/X.language</tt> directory and say
-<tscreen><verb>
+
+<item> Go to <tt>/usr/ports/russian/X.language</tt> directory and say
+<verb>
 # make all install
-</verb></tscreen>
+</verb>
 there. This port install latest version of KOI8-R fonts.
 <p>
 Check find <tt>"Files"</tt> section in your <tt>/etc/XF86Config</tt>,
 following lines must be before any other <tt>FontPath</tt> entries:
-<tscreen><verb>
+<verb>
     FontPath   "/usr/X11R6/lib/X11/fonts/cyrillic/misc"
     FontPath   "/usr/X11R6/lib/X11/fonts/cyrillic/75dpi"
     FontPath   "/usr/X11R6/lib/X11/fonts/cyrillic/100dpi"
-</verb></tscreen>
+</verb>
 <p>
 If you use high resolution video mode, swap 75 dpi and
 100 dpi lines.
-<p>
-To activate Russian keyboard add
-<tscreen><verb>
+
+<item> To activate Russian keyboard add
+<verb>
     XkbKeymap   "xfree86(ru)"
-</verb></tscreen>
+</verb>
 line into <tt>"Keyboard"</tt> section in your <tt>/etc/XF86Config</tt>,
 also make sure that <tt>XkbDisable</tt> is turned off (commented out)
 there.
 <p>
-RUS/LAT switch will be <it>CapsLock</it>.
+RUS/LAT switch will be <bf>CapsLock</bf>. Old CapsLock function still
+available via <bf>Shift+CapsLock</bf> (in LAT mode only).
 <p>
 <it>NOTE:</it>
 Russian XKB keyboard may not work with old XFree86 versions,
 see <ref id="russian:note" name="locale note"> for more info.
+</enum>