[Bug 190] reorganise and sync descriptions

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

1 files changed, 51 insertions, 20 deletions

diff --git a/appendixa/gcc-desc.xml b/appendixa/gcc-desc.xml
index 68235d189..7200a92c7 100644
--- a/appendixa/gcc-desc.xml
+++ b/appendixa/gcc-desc.xml
@@ -1,34 +1,65 @@
-<sect2>
-<title>Contents</title>
+<sect2><title>Contents of gcc-&gcc-contversion;</title>
 
-<para>The GCC package contains compilers, preprocessors and the GNU C++
-Library.</para>
+<sect3><title>Program Files</title>
+<para>c++, c++filt, cc (link to gcc), cc1, cc1plus, collect2, cpp, cpp0,
+g++, gcc, gcov, protoize and unprotoize</para></sect3>
 
-</sect2>
+<sect3><title>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>
 
-<sect2><title>Description</title>
+<sect4><title>c++filt</title>
+<para>c++filt is used to demangle C++ symbols.</para></sect4>
 
-<sect3><title>Compiler</title>
-<para>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></sect3>
+<sect4><title>collect2</title>
+<para>No description is currently available.</para></sect4>
 
-<sect3><title>Preprocessor</title>
-<para>A preprocessor pre-processes a source file, such as including
-the contents of header files into the source file. It's a good idea to 
-not 
-do this manually to save a lot of time. Someone just inserts a line
+<sect4><title>cpp, cpp0</title>
+<para>cpp pre-processes a source file, such as including
+the contents of header files into the source file. It's a good idea to
+not do this manually to save a lot of time. Someone just inserts a line
 like #include &lt;filename&gt;. The preprocessor inserts the
 contents of that file into the source file. That's one of the things a
-preprocessor does.</para></sect3>
+preprocessor does.</para></sect4>
+
+<sect4><title>gcov</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>protoize</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>unprotoize</title>
+<para>No description is currently available.</para></sect4>
 
-<sect3><title>C++ Library</title>
-<para>The C++ library is used by C++ programs. The C++ library contains
+</sect3>
+
+<sect3><title>Library Files</title>
+<para>libgcc.a, libiberty.a, libstdc++.[a,so]</para>
+
+<sect4><title>libgcc</title>
+<para>libgcc.a is a run-time support file for gcc.Most of the time, on most 
+machines, libgcc.a is not actually necessary.</para></sect4>
+
+<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>
+
+<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></sect3>
+program.</para></sect4>
+
+</sect3>
 
 </sect2>