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

diff --git a/appendixa/perl-desc.xml b/appendixa/perl-desc.xml
index 6c68f8a32..24b944279 100644
--- a/appendixa/perl-desc.xml
+++ b/appendixa/perl-desc.xml
@@ -1,16 +1,87 @@
-<sect2>
-<title>Contents</title>
+<sect2><title>Contents of perl-&perl-contversion;</title>
 
-<para>The Perl package contains Perl - Practical Extraction and Report
-Language</para>
+<sect3><title>Program Files</title>
+<para>a2p, c2ph, dprofpp, find2perl, h2ph, h2xs, perl, perl5.6.1,
+perlbug, perlcc, perldoc, pl2pm, pod2html, pod2latex, pod2man, pod2text,
+pod2usage, podchecker, podselect, pstruct, s2p and splain</para></sect3>
 
-</sect2>
+<sect3><title>Descriptions</title>
+
+<sect4><title>a2p</title>
+<para>a2p is an awk to perl translator.</para></sect4>
+
+<sect4><title>c2ph</title>
+<para>c2ph dumps C structures as generated from "cc -g -S" stabs.</para></sect4>
+
+<sect4><title>dprofpp</title>
+<para>dprofpp displays perl profile data.</para></sect4>
+
+<sect4><title>find2perl</title>
+<para>find2perl translates find command lines to Perl code.</para></sect4>
+
+<sect4><title>h2ph</title>
+<para>h2ph converts .h C header files to .ph Perl header files.</para></sect4>
+
+<sect4><title>h2xs</title>
+<para>h2xs converts .h C header files to Perl extensions.</para></sect4>
+
+<sect4><title>perl, perl5.6.1</title>
+<para>perl is the Practical Extraction and Report Language.  It combines
+some of the best features of C, sed, awk, and sh into one powerful
+language.</para></sect4>
+
+<sect4><title>perlbug</title>
+<para>perlbug helps to generate bug reports about perl or the
+modules that come with it, and mail them.</para></sect4>
+
+<sect4><title>perlcc</title>
+<para>perlcc generates executables from Perl programs.</para></sect4>
+
+<sect4><title>perldoc</title>
+<para>perldoc looks up a piece of documentation in .pod format that is
+embedded in the perl installation tree or in a perl script, and displays it 
+via "pod2man | nroff -man | $PAGER".</para></sect4>
+
+<sect4><title>pl2pm</title>
+<para>pl2pm is a tool to aid in the conversion of Perl4-style .pl library 
+files to Perl5-style library modules.</para></sect4>
+
+<sect4><title>pod2html</title>
+<para>pod2html converts files from pod format to HTML format.</para></sect4>
+
+<sect4><title>pod2latex</title>
+<para>pod2latex converts files from pod format to LaTeX format.</para></sect4>
+
+<sect4><title>pod2man</title>
+<para>pod2man converts pod data to formatted *roff input.</para></sect4>
+
+<sect4><title>pod2text</title>
+<para>pod2text converts pod data to formatted ASCII text.</para></sect4>
+
+<sect4><title>pod2usage</title>
+<para>pos2usage prints usage messages from embedded pod docs in 
+files.</para></sect4>
+
+<sect4><title>podchecker</title>
+<para>podchecker checks the syntax of pod format documentation 
+files.</para></sect4>
+
+<sect4><title>podselect</title>
+<para>podselect prints selected sections of pod documentation on
+standard output.</para></sect4>
+
+<sect4><title>pstruct</title>
+<para>pstruct dumps C structures as generated from "cc -g -S" 
+stabs.</para></sect4>
+
+<sect4><title>s2p</title>
+<para>s2p is a sed to perl translator.</para></sect4>
 
-<sect2>
-<title>Description</title>
+<sect4><title>splain</title>
+<para>splain is a program to force verbose warning diagnostics 
+in perl.</para></sect4>
 
-<para>Perl combines the features and capabilities of C, awk, sed and sh into
-one powerful programming language.</para>
+</sect3>
 
 </sect2>