Changeset 978d0bf for appendixa/ncurses-desc.xml

Timestamp:

09/24/2003 10:29:16 PM (21 years ago)

Author:

Alex Gronenwoud <alex@…>

Branches:

10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, 12.2, 12.2-rc1, 6.0, 6.1, 6.1.1, 6.3, 6.4, 6.5, 6.6, 6.7, 6.8, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.5-systemd, 7.6, 7.6-systemd, 7.7, 7.7-systemd, 7.8, 7.8-systemd, 7.9, 7.9-systemd, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, v5_0, v5_1, v5_1_1, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/loongarch-12.2, xry111/mips64el, xry111/multilib, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc

Children:

3a788f0c

Parents:

aa49729

Message:

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

File:

• appendixa/ncurses-desc.xml (modified) (2 diffs)

appendixa/ncurses-desc.xml

@@ -7 +7 @@
 <sect3><title>Program file descriptions</title>
 
-<sect4><title>captoinfo</title>
-<para>captoinfo converts a termcap description into a terminfo
-description.</para></sect4>
+<para><command>captoinfo</command> converts a termcap description into a
+terminfo description.</para>
 
-<sect4><title>clear</title>
-<para>clear clears the screen if this is possible. It looks in
-the environment for the terminal type and then in the terminfo database
-to figure out how to clear the screen.</para></sect4>
+<para><command>clear</command> clears the screen, if this is possible.</para>
 
-<sect4><title>infocmp</title>
-<para>infocmp can be used to compare a binary terminfo entry with
-other terminfo entries, rewrite a terminfo description to 
-take advantage of the use= terminfo field, or print out a
-terminfo description from the binary file (term) in a variety of 
-formats (the opposite of what tic does).</para></sect4>
+<para><command>infocmp</command> compares or prints out terminfo
+descriptions.</para>
 
-<sect4><title>infotocap</title>
-<para>info to cap converts a terminfo description into a termcap
-description.</para></sect4>
+<para><command>infotocap</command> converts a terminfo description into
+a termcap description.</para>
 
-<sect4><title>reset</title>
-<para>reset sets cooked and echo modes, turns off cbreak and raw modes, 
-turns on new-line translation and resets any unset special characters to
-their default values before doing terminal initialization the same way
-as tset.</para></sect4>
+<para><command>reset</command> reinitializes a terminal to its default
+values.</para>
 
-<sect4><title>tack</title>
-<para>tack is the terminfo action checker.</para></sect4>
+<para><command>tack</command> is the terminfo action checker. It is mainly
+used to test the correctness of an entry in the terminfo database.</para>
 
-<sect4><title>tic</title>
-<para>tic is the terminfo entry-description compiler. The program translates a
-terminfo file from source format into the binary format for use with the
-ncurses library routines. Terminfo files contain information about the
-capabilities of a terminal.</para></sect4>
+<para><command>tic</command> is the terminfo entry-description compiler.
+It translates a terminfo file from source format into the binary format needed
+for the ncurses library routines. A terminfo file contains information on the
+capabilities of a certain terminal.</para>
 
-<sect4><title>toe</title>
-<para>toe lists all available terminal types by primary name with
-descriptions.</para></sect4>
+<para><command>toe</command> lists all available terminal types, for each
+giving its primary name and its description.</para>
 
-<sect4><title>tput</title>
-<para>tput uses the terminfo database to make the values of
-terminal-dependent capabilities and information available to the shell,
-to initialize or reset the terminal, or return the long name of the
-requested terminal type.</para></sect4>
+<para><command>tput</command> makes the values of terminal-dependent
+capabilities available to the shell. It can also be used to reset or initialize
+a terminal, or report its long name.</para>
 
-<sect4><title>tset</title>
-<para>tset initializes terminals so they can be used, but it's not
-widely used anymore. It's provided for 4.4BSD compatibility.</para></sect4>
+<para><command>tset</command> can be used to initialize terminals.</para>
 
 </sect3>
@@ -60 +42 @@
 <sect3><title>Library file descriptions</title>
 
-<sect4><title>libcurses, libncurses++, libncurses, libncurses_g</title>
-<para>These libraries are the base of the system and are used to display
-text (often in a fancy way) on the screen. An example where ncurses is used
-is in the kernel's <quote>make menuconfig</quote> process.</para></sect4>
+<para><command>libncurses*</command> contain functions to display text in
+many complicated ways on a terminal screen. A good example of the use of these
+functions is the menu displayed during the kernel's make menuconfig.</para>
 
-<sect4><title>libform, libform_g</title>
-<para>libform is used to implement forms in ncurses.</para></sect4>
+<para><command>libform*</command> contain functions to implement forms.</para>
 
-<sect4><title>libmenu, libmenu_g</title>
-<para>libmenu is used to implement menus in ncurses.</para></sect4>
+<para><command>libmenu*</command> contain functions to implement menus.</para>
 
-<sect4><title>libpanel, libpanel_g</title>
-<para>libpanel is used to implement panels in ncurses.</para></sect4>
+<para><command>libpanel*</command> contain functions to implement panels.</para>
 
 </sect3>
 
 </sect2>
+