r5572 - in trunk/BOOK: . general/prog introduction/welcome

randy at linuxfromscratch.org randy at linuxfromscratch.org
Tue Jan 17 08:42:51 PST 2006


Author: randy
Date: 2006-01-17 09:42:50 -0700 (Tue, 17 Jan 2006)
New Revision: 5572

Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/general/prog/perl-modules.xml
   trunk/BOOK/introduction/welcome/changelog.xml
Log:
Updated to the HTML::TableExtract-2.06 Perl Module and added new modules HTML::Element::Extended and HTML::Tree as dependencies; also more reorganization and singling out of the Perl Modules

Modified: trunk/BOOK/general/prog/perl-modules.xml
===================================================================
--- trunk/BOOK/general/prog/perl-modules.xml	2006-01-17 06:03:04 UTC (rev 5571)
+++ trunk/BOOK/general/prog/perl-modules.xml	2006-01-17 16:42:50 UTC (rev 5572)
@@ -90,7 +90,7 @@
 
     <para>The Archive::Zip module allows a <application>Perl</application>
     program to create, manipulate, read, and write Zip archive files. The
-    modules listed below can be installed using the standard
+    modules listed below are installed using the standard
     <application>Perl</application> module
     <xref linkend="perl-standard-install"/>.</para>
 
@@ -197,7 +197,7 @@
     <command>perldoc Finance::Quote</command> for full information.
     Alternatively, you can issue <command>perldoc lib/Finance/Quote.pm</command>
     after unpacking the distribution tarball and changing into the top-level
-    directory. The module and dependencies can be installed using the
+    directory. The module and dependencies are installed using the
     standard <application>Perl</application> module
     <xref linkend="perl-standard-install"/>.</para>
 
@@ -241,7 +241,7 @@
     </indexterm>
 
     <para>The Finance::QuoteHist bundle is several modules designed to fetch
-    historical stock quotes from the web. The module and dependencies can be
+    historical stock quotes from the web. The module and dependencies are
     installed using the standard <application>Perl</application> module
     <xref linkend="perl-standard-install"/>.</para>
 
@@ -284,10 +284,8 @@
     </indexterm>
 
     <para>The HTML::Parser distribution is a collection of modules that parse
-    and extract information from HTML documents. In order to use the included
-    HTML::HeadParser module, you will also need to install
-    <xref linkend="perl-lwp"/>. The two modules listed below can be installed
-    using the standard <application>Perl</application> Module
+    and extract information from HTML documents. The modules listed below are
+    installed using the standard <application>Perl</application> module
     <xref linkend="perl-standard-install"/>.</para>
 
     <itemizedlist spacing='compact'>
@@ -313,6 +311,10 @@
             </itemizedlist>
 
           </listitem>
+          <listitem>
+            <para><xref linkend="perl-lwp"/> (run-time requirement for the
+            included HTML::HeadParser module)</para>
+          </listitem>
         </itemizedlist>
 
       </listitem>
@@ -327,7 +329,13 @@
       <primary sortas="g-HTML-TableExtract">HTML::TableExtract</primary>
     </indexterm>
 
-    <para></para>
+    <para>HTML::TableExtract is a module that simplifies the extraction of the
+    content contained in tables within HTML documents, extracted either as
+    text or encoded element trees. Tables of note may be specified using
+    Headers, Depth, Count, Attributes, or some combination of the four. The
+    module and dependencies are installed using the standard
+    <application>Perl</application> module
+    <xref linkend="perl-standard-install"/>.</para> 
 
     <itemizedlist spacing='compact'>
       <listitem>
@@ -337,8 +345,40 @@
 
         <itemizedlist>
           <listitem>
-            <para><xref linkend="perl-html-parser"/></para>
+            <para id="perl-html-element-extended"><ulink
+            url="http://cpan.org/authors/id/M/MS/MSISK/HTML-Element-Extended-&HTML-Element-Extended-version;.tar.gz">
+            HTML-Element-Extended-&HTML-Element-Extended-version;</ulink></para>
+            <indexterm zone="perl-modules perl-html-element-extended">
+              <primary sortas="g-HTML-Element-Extended">HTML::Element::Extended</primary>
+            </indexterm>
+
+            <itemizedlist>
+              <listitem>
+                <para id="perl-html-tree"><ulink
+                url="http://cpan.org/authors/id/P/PE/PETDANCE/HTML-Tree-&HTML-Tree-version;.tar.gz">
+                HTML-Tree-&HTML-Tree-version;</ulink></para>
+                <indexterm zone="perl-modules perl-html-tree">
+                  <primary sortas="g-HTML-Tree">HTML::Tree</primary>
+                </indexterm>
+
+                <itemizedlist>
+                  <listitem>
+                    <para><xref linkend="perl-html-parser"/></para>
+                  </listitem>
+                  <listitem>
+                    <para><xref linkend="perl-test-pod"/> (optionally used
+                    during the tests)</para>
+                  </listitem>
+                </itemizedlist>
+
+              </listitem>
+            </itemizedlist>
+
           </listitem>
+          <listitem>
+            <para><xref linkend="perl-test-pod-coverage"/> (optionally used
+            during the tests)</para>
+          </listitem>
         </itemizedlist>
 
       </listitem>
@@ -353,15 +393,15 @@
       <primary sortas="g-LWP">LWP</primary>
     </indexterm>
 
-    <para>The libwww-perl (LWP) collection is a set of
-    <application>Perl</application> modules which provides a simple and
+    <para>The LWP (libwww-perl) collection is a set of
+    <application>Perl</application> modules which provide a simple and
     consistent application programming interface to the World-Wide Web. The
     main focus of the library is to provide classes and functions that allow
     you to write WWW clients. The library also contains modules that are of
     more general use and even classes that help you implement simple HTTP
-    servers. The LWP modules and all its <application>Perl</application>
-    module dependencies can be installed using the standard
-    <application>Perl</application> Module
+    servers. The LWP collection and all its <application>Perl</application>
+    module dependencies are installed using the standard
+    <application>Perl</application> module
     <xref linkend="perl-standard-install"/>.</para>
 
     <itemizedlist spacing='compact'>
@@ -485,7 +525,7 @@
     <para>The Module::Build module (as well as any other
     <application>Perl</application> module that uses the Module::Build build
     system) uses <xref linkend="perl-module-build-install"/>. All the
-    dependencies can be installed using the standard
+    dependencies are installed using the standard
     <application>Perl</application> module
     <xref linkend="perl-standard-install"/>.</para>
 
@@ -600,7 +640,7 @@
     of uninstalled modules. The Module::Info module installs using the standard
     <application>Perl</application> module
     <xref linkend="perl-standard-install"/>. The version module requires using
-    the Module::Build installation method.</para>
+    the Module::Build <xref linkend="perl-module-build-install"/>.</para>
 
     <itemizedlist spacing='compact'>
       <listitem>
@@ -649,10 +689,12 @@
     tarball (if it includes a <filename>SIGNATURE</filename> file) by unpacking
     the tarball, changing into the newly created directory and issuing the
     command <command>cpansign -v</command>. It will check each file's
-    integrity, as well as the signature's validity. Some of the dependencies
-    appear to be circular, however, they are only run-time conflicts and you
-    should be able to fully utilize them as long as everything is
-    installed.</para>
+    integrity, as well as the signature's validity. Note that some of the
+    dependencies appear to be circular, however, they are only run-time
+    conflicts and you should be able to fully utilize them as long as
+    everything is installed. Module::Signature and the dependency modules are 
+    installed using the standard <application>Perl</application>
+    module <xref linkend="perl-standard-install"/>.</para>
 
     <itemizedlist spacing='compact'>
       <listitem>
@@ -695,58 +737,8 @@
 
             <itemizedlist>
               <listitem>
-                <para id="perl-test-pod-coverage"><ulink
-                url="http://cpan.org/authors/id/P/PE/PETDANCE/Test-Pod-Coverage-&Test-Pod-Coverage-version;.tar.gz">
-                Test-Pod-Coverage-&Test-Pod-Coverage-version;</ulink>
-                (optionally used during the tests).</para>
-                <indexterm zone="perl-modules perl-test-pod-coverage">
-                  <primary sortas="g-Test-Pod-Coverage">Test::Pod::Coverage</primary>
-                </indexterm>
-
-                <itemizedlist>
-                  <listitem>
-                    <para id="perl-test-builder-tester">
-                    <xref linkend="perl-test-simple"/> or
-                    <ulink
-                    url="http://cpan.org/authors/id/M/MA/MARKF/Test-Builder-Tester-&Test-Builder-Tester-version;.tar.gz">
-                    Test-Builder-Tester-&Test-Builder-Tester-version;</ulink></para>
-                    <indexterm zone="perl-modules perl-test-builder-tester">
-                      <primary sortas="g-Test-Builder-Tester">Test::Builder::Tester</primary>
-                    </indexterm>
-                  </listitem>
-                  <listitem>
-                    <para id="perl-pod-coverage"><ulink
-                    url="http://cpan.org/authors/id/R/RC/RCLAMP/Pod-Coverage-&Pod-Coverage-version;.tar.gz">
-                    Pod-Coverage-&Pod-Coverage-version;</ulink></para>
-                    <indexterm zone="perl-modules perl-pod-coverage">
-                      <primary sortas="g-Pod-Coverage">Pod::Coverage</primary>
-                    </indexterm>
-
-                    <itemizedlist>
-                      <listitem>
-                        <para id="perl-devel-symdump"><ulink
-                        url="http://cpan.org/authors/id/A/AN/ANDK/Devel-Symdump-&Devel-Symdump-version;.tar.gz">
-                        Devel-Symdump-&Devel-Symdump-version;</ulink></para>
-                        <indexterm zone="perl-modules perl-devel-symdump">
-                          <primary sortas="g-Devel-Symdump">Devel::Symdump</primary>
-                        </indexterm>
-
-                        <itemizedlist>
-                          <listitem>
-                            <para><xref linkend="perl-test-pod"/> (optionally
-                            used during the tests)</para>
-                          </listitem>
-                        </itemizedlist>
-
-                      </listitem>
-                      <listitem>
-                        <para><xref linkend="perl-module-build"/></para>
-                      </listitem>
-                    </itemizedlist>
-
-                  </listitem>
-                </itemizedlist>
-
+                <para><xref linkend="perl-test-pod-coverage"/> (optionally used
+                during the tests)</para>
               </listitem>
             </itemizedlist>
 
@@ -771,8 +763,8 @@
     <para>Net::DNS is a DNS resolver implemented in
     <application>Perl</application>. It can be used to perform nearly any type
     of DNS query from a <application>Perl</application> script. The Net::DNS
-    module and all its dependencies can be installed using the standard
-    <application>Perl</application> Module
+    module and all its dependencies are installed using the standard
+    <application>Perl</application> module
     <xref linkend="perl-standard-install"/>.</para>
 
     <itemizedlist spacing='compact'>
@@ -897,8 +889,8 @@
     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 standard <application>Perl</application> Module
+    distribution. This module and all the dependencies are installed using
+    the standard <application>Perl</application> module
     <xref linkend="perl-standard-install"/>.</para>
 
     <itemizedlist spacing='compact'>
@@ -936,6 +928,77 @@
       </listitem>
     </itemizedlist>
 
+    <!-- Test::Pod::Coverage -->
+    <bridgehead renderas="sect3" id="perl-test-pod-coverage"
+    xreflabel="Test::Pod::Coverage-&Test-Pod-Coverage-version;">
+    Test::Pod::Coverage-&Test-Pod-Coverage-version;</bridgehead>
+
+    <indexterm zone="perl-modules perl-test-pod-coverage">
+      <primary sortas="g-Test-Pod-Coverage">Test::Pod::Coverage</primary>
+    </indexterm>
+
+    <para>The Test::Pod::Coverage module is used to check files in a
+    distribution for POD coverage. It is normally used by developers to
+    ensure their projects are adequately covered with POD and it is also used
+    in the test suites of many module distributions. The Pod::Coverage module
+    requires using the Module::Build
+    <xref linkend="perl-module-build-install"/>, all the other modules are
+    installed using the standard <application>Perl</application> module
+    <xref linkend="perl-standard-install"/>.</para>
+
+    <itemizedlist spacing='compact'>
+      <listitem>
+        <para><ulink
+        url="http://cpan.org/authors/id/P/PE/PETDANCE/Test-Pod-Coverage-&Test-Pod-Coverage-version;.tar.gz">
+        Test-Pod-Coverage-&Test-Pod-Coverage-version;</ulink></para>
+
+        <itemizedlist>
+          <listitem>
+            <para id="perl-test-builder-tester">
+            <xref linkend="perl-test-simple"/> or
+            <ulink
+            url="http://cpan.org/authors/id/M/MA/MARKF/Test-Builder-Tester-&Test-Builder-Tester-version;.tar.gz">
+            Test-Builder-Tester-&Test-Builder-Tester-version;</ulink></para>
+            <indexterm zone="perl-modules perl-test-builder-tester">
+              <primary sortas="g-Test-Builder-Tester">Test::Builder::Tester</primary>
+            </indexterm>
+          </listitem>
+          <listitem>
+            <para id="perl-pod-coverage"><ulink
+            url="http://cpan.org/authors/id/R/RC/RCLAMP/Pod-Coverage-&Pod-Coverage-version;.tar.gz">
+            Pod-Coverage-&Pod-Coverage-version;</ulink></para>
+            <indexterm zone="perl-modules perl-pod-coverage">
+              <primary sortas="g-Pod-Coverage">Pod::Coverage</primary>
+            </indexterm>
+
+            <itemizedlist>
+              <listitem>
+                <para id="perl-devel-symdump"><ulink
+                url="http://cpan.org/authors/id/A/AN/ANDK/Devel-Symdump-&Devel-Symdump-version;.tar.gz">
+                Devel-Symdump-&Devel-Symdump-version;</ulink></para>
+                <indexterm zone="perl-modules perl-devel-symdump">
+                  <primary sortas="g-Devel-Symdump">Devel::Symdump</primary>
+                </indexterm>
+
+                <itemizedlist>
+                  <listitem>
+                    <para><xref linkend="perl-test-pod"/> (optionally used
+                    during the tests)</para>
+                  </listitem>
+                </itemizedlist>
+
+              </listitem>
+              <listitem>
+                <para><xref linkend="perl-module-build"/></para>
+              </listitem>
+            </itemizedlist>
+
+          </listitem>
+        </itemizedlist>
+
+      </listitem>
+    </itemizedlist>
+
     <!-- Test::Simple -->
     <bridgehead renderas="sect3" id="perl-test-simple"
     xreflabel="Test::Simple-&Test-Simple-version;">
@@ -991,7 +1054,10 @@
     <command>diff</command>, but it is better integrated with
     <application>Perl</application> and available on all platforms. Text::Diff
     is often faster than shelling out to a system's <command>diff</command>
-    executable for small files, and generally slower on larger files.</para>
+    executable for small files, and generally slower on larger files. The
+    modules listed below are installed using the standard
+    <application>Perl</application> module
+    <xref linkend="perl-standard-install"/>.</para>
 
     <itemizedlist spacing='compact'>
       <listitem>
@@ -1035,8 +1101,8 @@
     support via <application>Perl</application>'s and
     core-<application>Tk</application>'s use of UTF-8. Tk-&Tk-Perl-version;
     builds and loads into a threaded <application>Perl</application> but is NOT
-    yet thread safe. The module can be installed using the standard
-    <application>Perl</application> Module
+    yet thread safe. The module is installed using the standard
+    <application>Perl</application> module
     <xref linkend="perl-standard-install"/>.</para>
 
     <itemizedlist spacing='compact'>
@@ -1065,8 +1131,8 @@
 
     <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
-    standard <application>Perl</application> Module
+    <application>expat</application>. The module is installed using the
+    standard <application>Perl</application> module
     <xref linkend="perl-standard-install"/>.</para>
 
     <itemizedlist spacing='compact'>

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2006-01-17 06:03:04 UTC (rev 5571)
+++ trunk/BOOK/general.ent	2006-01-17 16:42:50 UTC (rev 5572)
@@ -188,9 +188,11 @@
 <!ENTITY ExtUtils-ParseXS-version     "2.15">
 <!ENTITY Finance-Quote-version        "1.10">
 <!ENTITY Finance-QuoteHist-version    "1.00">
+<!ENTITY HTML-Element-Extended-version "1.14">
 <!ENTITY HTML-Parser-version          "3.48">
-<!ENTITY HTML-TableExtract-version    "2.02">
+<!ENTITY HTML-TableExtract-version    "2.06">
 <!ENTITY HTML-Tagset-version          "3.10">
+<!ENTITY HTML-Tree-version            "3.1901">
 <!ENTITY IO-Socket-INET6-version      "2.51">
 <!ENTITY IO-Zlib-version              "1.04">
 <!ENTITY LWP-version                  "5.803">

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2006-01-17 06:03:04 UTC (rev 5571)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2006-01-17 16:42:50 UTC (rev 5572)
@@ -45,6 +45,12 @@
       <para>January 17th, 2006</para>
       <itemizedlist>
         <listitem>
+          <para>[randy] - Updated to the HTML::TableExtract-2.06 Perl Module
+          and added new modules HTML::Element::Extended and HTML::Tree as
+          dependencies; also more reorganization and singling out of the
+          Perl Modules.</para>
+        </listitem>
+        <listitem>
           <para>[tushar] - Change lynx installation target to install-full.</para>
         </listitem>
         <listitem>




More information about the blfs-book mailing list