[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, 30 insertions, 9 deletions

diff --git a/appendixa/flex-desc.xml b/appendixa/flex-desc.xml
index 14c87368d..6279fccfa 100644
--- a/appendixa/flex-desc.xml
+++ b/appendixa/flex-desc.xml
@@ -1,18 +1,39 @@
-<sect2>
-<title>Contents</title>
+<sect2><title>Contents of flex-&flex-contversion;</title>
 
-<para>The Flex package contains the flex program</para>
+<sect3><title>Program Files</title>
+<para>flex, flex++ (link to flex) and lex</para></sect3>
 
-</sect2>
-
-<sect2><title>Description</title>
+<sect3><title>Descriptions</title>
 
-<para>Flex is a tool for generating programs which recognize patterns in text. 
-Pattern recognition is very useful in many applications. A user sets up rules 
+<sect4><title>flex</title>
+<para>flex is a tool for generating programs which recognize 
+patterns in text.  Pattern recognition is very useful in many applications. 
+A user sets up rules 
 what to look for and flex will make a program that looks for those
 patterns. The reason people use flex is that it is much easier to sets up 
 rules for what to look for than to write the actual program that finds 
-the text.</para>
+the text.</para></sect4>
+
+<sect4><title>flex++</title>
+<para>flex++ invokes a version of flex which is used exclusively for 
+C++ scanners.</para></sect4>
+
+<sect4><title>lex</title>
+<para>We create a yacc script which calls flex using the -l option.
+This is for compatibility purposes for programs which use lex instead
+of flex.</para></sect4>
+
+</sect3>
+
+<sect3><title>Library Files</title>
+<para>libfl.a</para></sect3>
+
+<sect3><title>Descriptions</title>
+
+<sect4><title>libfl</title>
+<para>No description is currently available.</para></sect4>
+
+</sect3>
 
 </sect2>