Author: ken Date: Fri Sep 23 04:58:51 2016 New Revision: 17797 Log: 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.
Modified: trunk/BOOK/general/prog/perl-modules.xml trunk/BOOK/introduction/welcome/changelog.xml Modified: trunk/BOOK/general/prog/perl-modules.xml ============================================================================== --- trunk/BOOK/general/prog/perl-modules.xml Thu Sep 22 23:32:57 2016 (r17796) +++ trunk/BOOK/general/prog/perl-modules.xml Fri Sep 23 04:58:51 2016 (r17797) @@ -148,7 +148,11 @@ Also, for external modules where we link to CPAN without a current version, 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"> <?dbhtml filename="perl-modules.html" ?> @@ -175,6 +179,10 @@ 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 you wish to run the test for the module which uses it. In these cases, only the required dependencies are listed - there might be other modules which @@ -341,6 +349,29 @@ </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> + <!-- Class::Accessor --> <bridgehead renderas="sect3" id="perl-class-accessor" xreflabel="Class::Accessor-&Class-Accessor-version;"> @@ -1477,8 +1508,8 @@ </listitem> </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> </listitem> @@ -1575,8 +1606,8 @@ <listitem><literallayout><ulink url="http://search.cpan.org/dist/Config-AutoConf/";>Config::AutoConf</ulink> (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> (http://search.cpan.org/dist/LibBuilder/) Modified: trunk/BOOK/introduction/welcome/changelog.xml ============================================================================== --- trunk/BOOK/introduction/welcome/changelog.xml Thu Sep 22 23:32:57 2016 (r17796) +++ trunk/BOOK/introduction/welcome/changelog.xml Fri Sep 23 04:58:51 2016 (r17797) @@ -47,8 +47,10 @@ <para>September 23rd, 2016</para> <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> <para>[renodr] - Update to gnome-desktop-3.22.0. Partially fixes -- http://lists.linuxfromscratch.org/listinfo/blfs-book FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page
