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, 24 insertions, 52 deletions

diff --git a/appendixa/gcc-desc.xml b/appendixa/gcc-desc.xml
index 5acabb5b9..66f7dd23d 100644
--- a/appendixa/gcc-desc.xml
+++ b/appendixa/gcc-desc.xml
@@ -6,66 +6,38 @@
 
 <sect3><title>Program file descriptions</title>
 
-<sect4><title>cc, cc1, cc1plus, gcc</title>
-<para>These are the C compiler. A compiler translates source code in
-text format to a format that a computer understands. After a source code 
-file is compiled into an object file, a linker will create an executable 
-file from one or more of these compiler generated object files.</para></sect4>
-
-<sect4><title>c++, cc1plus, g++</title>
-<para>These are the C++ compiler, the equivalent of cc and 
-gcc etc.</para></sect4>
-
-<sect4><title>c++filt</title>
-<para>The C++ language provides function overloading, which means that it is
-possible to write many functions with the same name (providing each takes
-parameters of different types). All C++ function names are encoded into
-a low-level assembly label (this process is known as mangling). The c++filt
-program does the inverse mapping: it decodes (demangles) low-level names
-into user-level names so that the linker can keep these overloaded functions
-from clashing.</para></sect4>
-
-<sect4><title>collect2</title>
-<para>collect2 assists with the compilation of constructors.</para></sect4>
-
-<sect4><title>cpp, cpp0</title>
-<para>cpp pre-processes a source file, such as including the contents of
-header files into the source file. Simply add a line, such as #include
-&lt;filename&gt;, to your source file. The preprocessor will insert the
-contents of the included file into the source file.</para></sect4>
-
-<sect4><title>gccbug</title>
-<para>gccbug is a shell script which is used to simplify the creation of
-bug reports.</para></sect4>
-
-<sect4><title>gcov</title>
-<para>gcov analyzes programs to help create more efficient, faster running
-code through optimization.</para></sect4>
-
-<sect4><title>tradcpp0</title>
-<para>No description is currently available.</para></sect4>
+<para><command>c++filt</command> is used by the linker to demangle C++
+symbols, to keep overloaded functions from clashing.</para>
+
+<para><command>cpp</command> is the C preprocessor. It is used by the
+compiler to have the #include and #define and such statements expanded in
+the source files.</para>
+
+<para><command>g++</command> is the C++ compiler.</para>
+
+<para><command>gcc</command> is the C compiler. It is used to translate
+the source code of a program into assembly code.</para>
+
+<para><command>gccbug</command> is a shell script used to help create
+good bug reports.</para>
+
+<para><command>gcov</command> is a coverage testing tool. It is used to
+analyze programs to find out where optimizations will have the most effect.</para>
 
 </sect3>
 
 <sect3><title>Library file descriptions</title>
 
-<sect4><title>libgcc, libgcc_eh, libgcc_s</title>
-<para>Run-time support files for gcc.</para></sect4>
+<para><command>libgcc*</command> contains run-time support for gcc.</para>
 
-<sect4><title>libiberty</title>
-<para>libiberty is a collection of subroutines used by various GNU
-programs including getopt, obstack, strerror, strtol and strtoul.</para></sect4>
+<para><command>libiberty</command> contains routines used by various GNU
+programs, including getopt, obstack, strerror, strtol and strtoul.</para>
 
-<sect4><title>libstdc++</title>
-<para>libstdc++ is the C++ library. It is used by C++ programs and contains
-functions that are frequently used in C++ programs. This way the
-programmer doesn't have to write certain functions (such as writing a
-string of text to the screen) from scratch every time he creates a
-program.</para></sect4>
+<para><command>libstdc++</command> is the standard C++ library. It contains
+many frequently-used functions.</para>
 
-<sect4><title>libsupc++</title>
-<para>libsupc++ provides support for the c++ programming language. Among other
-things, libsupc++ contains routines for exception handling.</para></sect4>
+<para><command>libsupc++</command> provides supporting routines
+for the c++ programming language.</para>
 
 </sect3>