Changeset 2d85af0

Timestamp:

09/23/2016 11:58:51 AM (8 years ago)

Author:

Ken Moffat <ken@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

98f34bca

Parents:

802de072

Message:

Perl Modules : add a top level entry, but without version etc, where a dependant module is used by more than one other listed module. At the moment, I think that only Capture::Tiny is in this category, but the extra dependencies for biblatex-biber-2.6 will add at least two more similar situations.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17797 af4574ff-66df-0310-9fd7-8a98e5e911e0

Files:

• general/prog/perl-modules.xml (modified) (5 diffs)
• introduction/welcome/changelog.xml (modified) (1 diff)

general/prog/perl-modules.xml

@@ -149 +149 @@
  prefer to use http://search.cpan.org/dist/Module-Name if that works, rather
  than pointing to a maintainers home directory : the maintainer for a package
- sometimes changes -->
+ sometimes changes.
+
+ Where a dependency is used by multiple other modules on this page, but not by
+ packages elsewhere in the book, promote it to a top-level entry so that it can
+ be linked - but do not give it a version.  See Capture::Tiny for an example. -->
 
 <sect1 id="perl-modules" xreflabel="Perl modules">
@@ -175 +179 @@
     build and installation instructions are shown at the bottom of this page.
     </para>
+
+    <para>Where a module is used by more than one other module on this page,
+    but not by other packages in the book, it is listed by name here (without
+    a version) so that it can be linked from multiple places on this page.</para>
 
     <para>Where a module is shown as '(for the testsuite)' it is required if
@@ -339 +347 @@
 <literallayout>&Business-ISSN-download-http;
 MD5 sum: &Business-ISSN-md5sum;</literallayout>
+      </listitem>
+    </itemizedlist>
+
+    <!-- Capture::Tiny is a dependency of multiple modules on this page
+         But it is not linked from other pages, so only give minimal details -->
+
+    <bridgehead renderas="sect3" id="perl-capture-tiny"
+    xreflabel="Capture::Tiny">
+    Capture::Tiny</bridgehead>
+
+    <indexterm zone="perl-modules perl-capture-tiny">
+      <primary sortas="a-Capture-Tiny">Capture::Tiny</primary>
+    </indexterm>
+
+    <para>The Business::ISSN module captures STDOUT and STDERR from Perl, XS or
+    external programs.  This module uses the standard
+    <xref linkend="perl-standard-install"/>.</para>
+
+    <itemizedlist>
+      <listitem>
+        <para>
+          <ulink url="http://search.cpan.org/dist/Capture-Tiny/">Capture::Tiny;</ulink>
+        </para>
       </listitem>
     </itemizedlist>
@@ -1478 +1509 @@
             </itemizedlist>
           </listitem>
-          <listitem><literallayout><ulink url="http://search.cpan.org/dist/Capture-Tiny/">Capture::Tiny (for the testsuite)</ulink>
-(http://search.cpan.org/dist/Capture-Tiny/)</literallayout>
+          <listitem>
+            <para><xref linkend="perl-capture-tiny"/></para>
           </listitem>
         </itemizedlist>
@@ -1576 +1607 @@
 (http://search.cpan.org/dist/Config-AutoConf/)</literallayout>
             <itemizedlist>
-              <listitem><literallayout><ulink url="http://search.cpan.org/dist/Capture-Tiny/">Capture::Tiny</ulink>
-(http://search.cpan.org/dist/Capture-Tiny/)</literallayout>
+              <listitem>
+                <para><xref linkend="perl-capture-tiny"/></para>
               </listitem>
               <listitem><literallayout><ulink url="http://search.cpan.org/dist/ExtUtils-LibBuilder/">ExtUtils-LibBuilder</ulink>

introduction/welcome/changelog.xml

@@ -48 +48 @@
       <itemizedlist>
         <listitem>
-          <para>[renodr] - Update to vte-0.46.0. Partially fixes
-          <ulink url="&blfs-ticket-root;8316">#8316</ulink>.</para>
+          <para>[ken] - Perl Modules - where a module is used by more than one
+          other module, but not by other packages in the book, move its entry
+          to the top level, but keep it as a second-class citizen without a
+          specific version.</para>
         </listitem>
         <listitem>