r5559 - trunk/BOOK/general/prog

randy at linuxfromscratch.org randy at linuxfromscratch.org
Sun Jan 15 13:36:57 PST 2006


Author: randy
Date: 2006-01-15 14:36:56 -0700 (Sun, 15 Jan 2006)
New Revision: 5559

Modified:
   trunk/BOOK/general/prog/perl-modules.xml
Log:
Minor textual fixes and alphabetized the Perl Modules instructions (2 of 2)

Modified: trunk/BOOK/general/prog/perl-modules.xml
===================================================================
--- trunk/BOOK/general/prog/perl-modules.xml	2006-01-15 21:03:05 UTC (rev 5558)
+++ trunk/BOOK/general/prog/perl-modules.xml	2006-01-15 21:36:56 UTC (rev 5559)
@@ -719,20 +719,59 @@
       </listitem>
     </itemizedlist>
 
+    <!-- SGMLSpm -->
+    <bridgehead renderas="sect3" id="perl-sgmlspm"
+    xreflabel="SGMLSpm-&SGMLSpm-version;">
+    SGMLSpm-&SGMLSpm-version;</bridgehead>
+
+    <indexterm zone="perl-modules perl-sgmlspm">
+      <primary sortas="g-SGMLSpm">SGMLSpm</primary>
+    </indexterm>
+
+    <para>The SGMLSpm module is a <application>Perl</application> library
+    used for parsing the output from James Clark's SGMLS and NSGMLS
+    parsers. This module requires modified installation instructions, shown
+    below.</para>
+
+    <itemizedlist spacing='compact'>
+      <listitem>
+        <para><ulink
+        url="http://cpan.org/authors/id/D/DM/DMEGG/SGMLSpm-&SGMLSpm-version;.tar.gz">
+        SGMLSpm-&SGMLSpm-version;</ulink></para>
+      </listitem>
+    </itemizedlist>
+
+    <para>If your system's <application>Perl</application> version is different
+    than &LFS-Perl-version;, you'll need to modify the <command>sed</command>
+    command below to reflect the version you have installed.</para>
+
+<screen><userinput>sed -i -e "s@/usr/local/bin@/usr/bin@" \
+       -e "s@/usr/local/lib/perl5@/usr/lib/perl5/site_perl/&LFS-Perl-version;@" \
+       -e "s@/usr/local/lib/www/docs@/usr/share/doc/perl5@" \
+    Makefile</userinput></screen>
+
+    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>make install &&
+install -v -m755 -d /usr/share/doc/perl5 &&
+make install_html &&
+rm -v -f /usr/share/doc/perl5/SGMLSpm/sample.pl &&
+install -v -m644 DOC/sample.pl /usr/share/doc/perl5/SGMLSpm</userinput></screen>
+
     <!-- Test::Pod -->
     <bridgehead renderas="sect3" id="perl-test-pod"
-    xreflabel="Test::Pod">The Test::Pod Module</bridgehead>
+    xreflabel="Test::Pod-&Test-Pod-version;">
+    Test::Pod-&Test-Pod-version;</bridgehead>
 
     <indexterm zone="perl-modules perl-test-pod">
       <primary sortas="g-Test-Pod">Test::Pod</primary>
     </indexterm>
 
-    <para>Another useful module, and one which is (typically optionally) used
-    by other modules during the build process is the Test:Pod module. This
-    module is used to check the validity of POD (Plain Old Documentation)
-    files. The Test::Pod module is typically included by module authors to
-    automatically find and check all POD files in a module distribution. This
-    module and all the dependencies can be installed using the
+    <para>The Test:Pod module is (most of the time, optionally) used by other
+    modules during the build process to check the validity of POD (Plain Old
+    Documentation) files. The Test::Pod module is typically included by module
+    authors to automatically find and check all POD files in a module
+    distribution. This module and all the dependencies can be installed using the
     <xref linkend="perl-standard-install"/>.</para>
 
     <itemizedlist spacing='compact'>
@@ -772,7 +811,8 @@
 
     <!-- Test::Simple -->
     <bridgehead renderas="sect3" id="perl-test-simple"
-    xreflabel="Test::Simple">The Test::Simple Module</bridgehead>
+    xreflabel="Test::Simple-&Test-Simple-version;">
+    Test::Simple-&Test-Simple-version;</bridgehead>
 
     <indexterm zone="perl-modules perl-test-simple">
       <primary sortas="g-Test-Simple">Test::Simple</primary>
@@ -801,100 +841,64 @@
       </listitem>
     </itemizedlist>
 
-    <!-- XML::Parser -->
-    <bridgehead renderas="sect3" id="perl-xml-parser"
-    xreflabel="XML::Parser">The XML::Parser Module</bridgehead>
+    <!-- Tk -->
+    <bridgehead renderas="sect3" id="perl-tk"
+    xreflabel="Perl-Tk-&Perl-Tk-version;">
+    Tk-&Perl-Tk-version;</bridgehead>
 
-    <indexterm zone="perl-modules perl-xml-parser">
-      <primary sortas="g-XML-Parser">XML::Parser</primary>
+    <indexterm zone="perl-modules perl-tk">
+      <primary sortas="g-Tk">Tk</primary>
     </indexterm>
 
-    <para>The XML::Parser module is a <application>Perl</application> extension
-    interface to James Clark's XML parser,
-    <application>expat</application>. The module can be installed using the
+    <para>The <application>Tk</application> module is a
+    <application>Perl</application> interface to the
+    <application>Tk</application> package. The goal of this release is Unicode
+    support via <application>Perl</application>'s and
+    core-<application>Tk</application>'s use of UTF-8. Tk-&Perl-Tk-version;
+    builds and loads into a threaded <application>Perl</application> but is NOT
+    yet thread safe. The module can be installed using the
     <application>Perl</application> Module
     <xref linkend="perl-standard-install"/>.</para>
 
     <itemizedlist spacing='compact'>
       <listitem>
         <para><ulink
-        url="http://cpan.org/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz">
-        XML-Parser-&XML-Parser-version;</ulink></para>
+        url="http://cpan.org/authors/id/N/NI/NI-S/Tk-&Perl-Tk-version;.tar.gz">
+        Tk-&Perl-Tk-version;</ulink></para>
 
         <itemizedlist>
           <listitem>
-            <para><xref linkend="expat"/></para>
+            <para><xref linkend="tk"/> and <xref linkend="libjpeg"/></para>
           </listitem>
         </itemizedlist>
 
       </listitem>
     </itemizedlist>
 
-    <!-- SGMLSpm -->
-    <bridgehead renderas="sect3" id="perl-sgmlspm"
-    xreflabel="SGMLSpm">The SGMLSpm Module</bridgehead>
+    <!-- XML::Parser -->
+    <bridgehead renderas="sect3" id="perl-xml-parser"
+    xreflabel="XML::Parser-&XML-Parser-version;">
+    XML::Parser-&XML-Parser-version;</bridgehead>
 
-    <indexterm zone="perl-modules perl-sgmlspm">
-      <primary sortas="g-SGMLSpm">SGMLSpm</primary>
+    <indexterm zone="perl-modules perl-xml-parser">
+      <primary sortas="g-XML-Parser">XML::Parser</primary>
     </indexterm>
 
-    <para>The SGMLSpm module is a <application>Perl</application> library
-    used for parsing the output from James Clark's SGMLS and NSGMLS
-    parsers. This module requires modified installation instructions, shown
-    below.</para>
-
-    <itemizedlist spacing='compact'>
-      <listitem>
-        <para><ulink
-        url="http://cpan.org/authors/id/D/DM/DMEGG/SGMLSpm-&SGMLSpm-version;.tar.gz">
-        SGMLSpm-&SGMLSpm-version;</ulink></para>
-      </listitem>
-    </itemizedlist>
-
-    <para>If your system's <application>Perl</application> version is different
-    than &LFS-Perl-version;, you'll need to modify the <command>sed</command>
-    command below to reflect the version you have installed.</para>
-
-<screen><userinput>sed -i -e "s@/usr/local/bin@/usr/bin@" \
-       -e "s@/usr/local/lib/perl5@/usr/lib/perl5/site_perl/&LFS-Perl-version;@" \
-       -e "s@/usr/local/lib/www/docs@/usr/share/doc/perl5@" \
-    Makefile</userinput></screen>
-
-    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
-
-<screen role="root"><userinput>make install &&
-install -v -d -m755 /usr/share/doc/perl5 &&
-make install_html &&
-rm -v -f /usr/share/doc/perl5/SGMLSpm/sample.pl &&
-install -v -m644 DOC/sample.pl /usr/share/doc/perl5/SGMLSpm</userinput></screen>
-
-    <!-- Tk -->
-    <bridgehead renderas="sect3" id="perl-tk"
-    xreflabel="Perl-Tk">The Tk Module</bridgehead>
-
-    <indexterm zone="perl-modules perl-tk">
-      <primary sortas="g-Tk">Tk</primary>
-    </indexterm>
-
-    <para>The <application>Tk</application> module is a
-    <application>Perl</application> interface to the
-    <application>Tk</application> package. The goal of this release is Unicode
-    support via <application>Perl</application>'s and
-    core-<application>Tk</application>'s use of UTF-8. Tk-&Perl-Tk-version;
-    builds and loads into a threaded <application>Perl</application> but is NOT
-    yet thread safe. The module can be installed using the
+    <para>The XML::Parser module is a <application>Perl</application> extension
+    interface to James Clark's XML parser,
+    <application>expat</application>. The module can be installed using the
     <application>Perl</application> Module
     <xref linkend="perl-standard-install"/>.</para>
 
     <itemizedlist spacing='compact'>
       <listitem>
         <para><ulink
-        url="http://cpan.org/authors/id/N/NI/NI-S/Tk-&Perl-Tk-version;.tar.gz">
-        Tk-&Perl-Tk-version;</ulink></para>
+        url="http://cpan.org/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz">
+        XML-Parser-&XML-Parser-version;</ulink></para>
 
         <itemizedlist>
           <listitem>
-            <para><xref linkend="tk"/> and <xref linkend="libjpeg"/></para>
+            <para><xref linkend="expat"/></para>
           </listitem>
         </itemizedlist>
 
@@ -924,11 +928,11 @@
     <title>(Alternate) Auto Installation of Perl Modules.</title>
 
     <para>There is an alternate way of installing the modules using
-    <application>Perl</application>'s built-in <command>install</command> command.
-    The command automatically downloads the source from the CPAN
-    archive, extracts it, runs the commands mentioned above, and removes the build
-    tree. You may still need to install dependent library packages before running
-    the automated installation method.</para>
+    <application>Perl</application>'s built-in <command>install</command>
+    command. The command automatically downloads the source from the CPAN
+    archive, extracts it, runs the commands mentioned above, and removes the
+    build source tree. You may still need to install dependent library
+    packages before running the automated installation method.</para>
 
     <para>The first time you run this command, you'll be prompted to enter some
     information regarding download locations and methods. This information is
@@ -938,7 +942,8 @@
 
 <screen role="root"><userinput>perl -MCPAN -e shell</userinput></screen>
 
-    <para>Each module may now be installed from this shell with the command:</para>
+    <para>Each module may now be installed from this shell with the
+    command:</para>
 
 <screen role="root"><userinput>install <replaceable>[Module::Name]</replaceable></userinput></screen>
 




More information about the blfs-book mailing list