Changing the style of the command descriptions in appendix A.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@2879 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

1 files changed, 35 insertions, 60 deletions

diff --git a/appendixa/kbd-desc.xml b/appendixa/kbd-desc.xml
index 09f139c16..10c6c9f2f 100644
--- a/appendixa/kbd-desc.xml
+++ b/appendixa/kbd-desc.xml
@@ -6,89 +6,64 @@
 
 <sect3><title>Program file descriptions</title>
 
-<sect4><title>chvt</title>
-<para>chvt changes foreground virtual terminal.</para></sect4>
+<para><command>chvt</command> changes the foreground virtual terminal.</para>
 
-<sect4><title>deallocvt</title>
-<para>deallocvt deallocates unused virtual terminals.</para></sect4>
+<para><command>deallocvt</command> deallocates unused virtual terminals.</para>
 
-<sect4><title>dumpkeys</title>
-<para>dumpkeys dumps keyboard translation tables.</para></sect4>
+<para><command>dumpkeys</command> dumps the keyboard translation tables.</para>
 
-<sect4><title>fgconsole</title>
-<para>fgconsole prints the number of the active virtual terminal.</para></sect4>
+<para><command>fgconsole</command> prints the number of the active virtual terminal.</para>
 
-<sect4><title>getkeycodes</title>
-<para>getkeycodes prints the kernel scancode-to-keycode 
-mapping table.</para></sect4>
+<para><command>getkeycodes</command> prints the kernel scancode-to-keycode
+mapping table.</para>
 
-<sect4><title>getunimap</title>
-<para>getunimap prints the currently used unimap.</para></sect4>
+<para><command>getunimap</command> prints the currently used unimap.</para>
 
-<sect4><title>kbd_mode</title>
-<para>kbd_mode reports or sets the keyboard mode.</para></sect4>
+<para><command>kbd_mode</command> reports or sets the keyboard mode.</para>
 
-<sect4><title>kbdrate</title>
-<para>kbdrate sets the keyboard repeat and delay rates.</para></sect4>
+<para><command>kbdrate</command> sets the keyboard repeat and delay rates.</para>
 
-<sect4><title>loadkeys</title>
-<para>loadkeys loads keyboard translation tables.</para></sect4>
+<para><command>loadkeys</command> loads the keyboard translation tables.</para>
 
-<sect4><title>loadunimap</title>
-<para>loadunimap loads the kernel unicode-to-font mapping table.</para></sect4>
+<para><command>loadunimap</command> loads the kernel unicode-to-font mapping table.</para>
 
-<sect4><title>mapscrn</title>
-<para>mapscrn loads a user defined output character
-mapping table into the console driver. Note that it is obsolete and that its
-features are built into setfont.</para></sect4>
+<para><command>mapscrn</command> is an obsolete program that used to load
+a user-defined output character mapping table into the console driver. This is
+now done by setfont.</para>
 
-<sect4><title>openvt</title>
-<para>openvt starts a program on a new virtual terminal (VT).</para></sect4>
+<para><command>openvt</command> starts a program on a new virtual terminal (VT).</para>
 
-<sect4><title>psfaddtable, psfgettable, psfstriptable, psfxtable</title>
-<para>These are a set of tools for handling Unicode character tables for 
-console fonts.</para></sect4>
+<para><command>psf*</command> are a set of tools for handling Unicode
+character tables for console fonts.</para>
 
-<sect4><title>resizecons</title>
-<para>resizecons changes the kernel idea of the console size.</para></sect4>
+<para><command>resizecons</command> changes the kernel idea of the console size.</para>
 
-<sect4><title>setfont</title>
-<para>This lets you change the EGA/VGA fonts in console.</para></sect4>
+<para><command>setfont</command> lets you change the EGA/VGA fonts on the console.</para>
 
-<sect4><title>setkeycodes</title>
-<para>setkeycodes loads kernel scancode-to-keycode mapping 
-table entries.</para></sect4>
+<para><command>setkeycodes</command> loads kernel scancode-to-keycode
+mapping table entries, useful if you have some unusual keys on your keyboard.</para>
 
-<sect4><title>setleds</title>
-<para>setleds sets the keyboard LEDs. Many people find it useful to have numlock
-enabled by default and, by using this program, you can 
-achieve this.</para></sect4>
+<para><command>setleds</command> sets the keyboard flags and LEDs. Many
+people find it useful to have NumLock on by default, setleds +num achieves this.</para>
 
-<sect4><title>setlogcons</title>
-<para>setlogcons sends kernel messages to the console.</para></sect4>
+<para><command>setlogcons</command> sends kernel messages to the console.</para>
 
-<sect4><title>setmetamode</title>
-<para>setmetamode defines the keyboard meta key handling.</para></sect4>
+<para><command>setmetamode</command> defines the keyboard meta key handling.</para>
 
-<sect4><title>setvesablank</title>
-<para>This lets you fiddle with the built-in hardware screensaver 
-(not toasters, only a blank screen).</para></sect4>
+<para><command>setvesablank</command> lets you fiddle with the built-in
+hardware screensaver (no toasters, just a blank screen).</para>
 
-<sect4><title>showfont</title>
-<para>showfont displays data about a font. The information shown includes font
-information, font properties, character metrics and 
-character bitmaps.</para></sect4>
+<para><command>showfont</command> displays data about a font, including
+font properties, character metrics and character bitmaps.</para>
 
-<sect4><title>showkey</title>
-<para>showkey examines the scancodes and keycodes sent by 
-the keyboard.</para></sect4>
+<para><command>showkey</command> reports the scancodes and keycodes and
+ASCII codes of the keys pressed on the keyboard.</para>
 
-<sect4><title>unicode_start</title>
-<para>unicode_start puts the console in Unicode mode.</para></sect4>
+<para><command>unicode_start</command> puts the keyboard and console in
+unicode mode.</para>
 
-<sect4><title>unicode_stop</title>
-<para>unicode_stop reverts keyboard and console from 
-unicode mode.</para></sect4>
+<para><command>unicode_stop</command> reverts keyboard and console from
+unicode mode.</para>
 
 </sect3>