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, 47 insertions, 71 deletions

diff --git a/appendixa/sysvinit-desc.xml b/appendixa/sysvinit-desc.xml
index 51cfde350..ec9af5434 100644
--- a/appendixa/sysvinit-desc.xml
+++ b/appendixa/sysvinit-desc.xml
@@ -6,77 +6,53 @@
 
 <sect3><title>Program file descriptions</title>
 
-<sect4><title>halt</title>
-<para>halt notes, in the file /var/log/wtmp, that the system is being
-brought down and then tells the kernel to either halt, reboot or 
-poweroff the system. If halt or reboot is called when the system is not 
-in runlevel 0 or 6, shutdown will be invoked instead (with 
-the flag -h or -r).</para></sect4>
-
-<sect4><title>init</title>
-<para>init is the parent of all processes. Its primary role is to create 
-processes from a script stored in the file /etc/inittab. This
-file usually has entries which cause init to spawn gettys on each line from
-which users can log in. It also controls autonomous processes required by any 
-particular system.</para></sect4>
-
-<sect4><title>killall5</title>
-<para>killall5 is the SystemV killall command. It sends a signal to all 
-processes except the processes in its own session, so it won't kill the 
-shell that is running the script it was called from.</para></sect4>
-
-<sect4><title>last</title>
-<para>last searches back through the file /var/log/wtmp (or the file designated 
-by the -f flag) and displays a list of all users logged in (and out) 
-since that file was created.</para></sect4>
-
-<sect4><title>lastb</title>
-<para>lastb is the same as last, except that by default it shows a log of the 
-file /var/log/btmp, which contains all the bad login attempts.</para></sect4>
-
-<sect4><title>mesg</title>
-<para>mesg controls the access to the user's terminal by others. It's typically
-used to allow or disallow other users to write to his terminal.</para></sect4>
-
-<sect4><title>pidof</title>
-<para>pidof displays the process identifiers (PIDs) of the named
-programs.</para></sect4>
-
-<sect4><title>poweroff</title>
-<para>poweroff is equivalent to shutdown -h -p now. It halts the computer and
-switches off the computer (when using an APM compliant BIOS and APM is 
-enabled in the kernel).</para></sect4>
-
-<sect4><title>reboot</title>
-<para>reboot is equivalent to shutdown -r now. It reboots 
-the computer.</para></sect4>
-
-<sect4><title>runlevel</title>
-<para>runlevel reads the system utmp file (usually /var/run/utmp), locates
-the runlevel record and prints the previous and current system 
-runlevel on its standard output, separated by a single space.</para></sect4>
-
-<sect4><title>shutdown</title>
-<para>shutdown brings the system down in a secure way. All logged-in users are 
-notified that the system is going down and login is blocked.</para></sect4>
-
-<sect4><title>sulogin</title>
-<para>sulogin is invoked by init when the system goes into single user mode 
-(this is done through an entry in /etc/inittab). Init also tries to 
-execute sulogin when it is passed the -b flag from the boot loader 
-(LILO, for example).</para></sect4>
-
-<sect4><title>telinit</title>
-<para>telinit sends appropriate signals to init, telling it which runlevel to
-enter.</para></sect4>
-
-<sect4><title>utmpdump</title>
-<para>utmpdumps prints the content of a file (usually /var/run/utmp) on
-standard output in a user friendly format.</para></sect4>
-
-<sect4><title>wall</title>
-<para>wall sends a message to logged in users that have their mesg permission 
-set to yes.</para></sect4>
+<para><command>halt</command> normally invokes shutdown with the -h flag,
+except when already in runlevel 0, then it tells the kernel to halt the system.
+But first it notes in the file <filename>/var/log/wtmp</filename> that the
+system is being brought down.</para>
+
+<para><command>init</command> is the mother of all processes. It reads its
+commands from <filename>/etc/inittab</filename>, which normally tell it which
+scripts to run for which runlevel, and how many gettys to spawn.</para>
+
+<para><command>killall5</command> sends a signal to all processes, except
+the processes in its own session -- so it won't kill the shell running the
+script that called it.</para>
+
+<para><command>last</command> shows which users last logged in (and out),
+searching back through the file <filename>/var/log/wtmp</filename>. It can
+also show system boots and shutdowns, and runlevel changes.</para>
+
+<para><command>lastb</command> shows the failed login attempts, as logged
+in <filename>/var/log/btmp</filename>.</para>
+
+<para><command>mesg</command> controls whether other users can send
+messages to the current user's terminal.</para>
+
+<para><command>pidof</command> reports the PIDs of the given programs.</para>
+
+<para><command>poweroff</command> tells the kernel to halt the system and
+switch off the computer. But see halt.</para>
+
+<para><command>reboot</command> tells the kernel to reboot the system.
+But see halt.</para>
+
+<para><command>runlevel</command> reports the previous and the current
+runlevel, as noted in the last runlevel record  in
+<filename>/var/run/utmp</filename>.</para>
+
+<para><command>shutdown</command> brings the system down in a secure way,
+signaling all processes and notifying all logged-in users.</para>
+
+<para><command>sulogin</command> allows the superuser to log in. It is
+normally invoked by init when the system goes into single user mode.</para>
+
+<para><command>telinit</command> tells init which runlevel to enter.</para>
+
+<para><command>utmpdump</command> displays the content of  the given login
+file in a friendlier format.</para>
+
+<para><command>wall</command> writes a message to all logged-in users.</para>
 
 </sect3>