Author: pierre
Date: Sat Sep 8 12:17:15 2018
New Revision: 20476
Log:
Give explicit build instructions for perl modules, instead of a link:
- Add two files in the xincludes directory
- Use <xi:xinclude> with href pointing to one of those files
Note that the files which are "xincluded" must be well formed XML
files. As such, they must have a unique top element. I choose to
have a <para> top element, which means <screen> elements are inside
it. This does not seem to change the rendered book, though.
Added:
branches/perl-modules/xincludes/perl-build-install.xml
branches/perl-modules/xincludes/perl-standard-install.xml
Modified:
branches/perl-modules/general/prog/perl-deps/perl-capture-tiny.xml
branches/perl-modules/general/prog/perl-deps/perl-config-autoconf.xml
branches/perl-modules/general/prog/perl-deps/perl-extutils-libbuilder.xml
branches/perl-modules/general/prog/perl-deps/perl-sub-identify.xml
branches/perl-modules/general/prog/perl-deps/perl-super.xml
branches/perl-modules/general/prog/perl-deps/perl-test-mockmodule.xml
branches/perl-modules/general/prog/perl-deps/perl-test-warnings.xml
branches/perl-modules/general/prog/perl-modules/perl-archive-zip.xml
branches/perl-modules/general/prog/perl-modules/perl-autovivification.xml
branches/perl-modules/general/prog/perl-modules/perl-business-issn.xml
branches/perl-modules/general/prog/perl-modules/perl-module-build.xml
branches/perl-modules/general/prog/perl-modules/perl-text-bibtex.xml
Modified: branches/perl-modules/general/prog/perl-deps/perl-capture-tiny.xml
==============================================================================
--- branches/perl-modules/general/prog/perl-deps/perl-capture-tiny.xml Sat Sep
8 10:41:32 2018 (r20475)
+++ branches/perl-modules/general/prog/perl-deps/perl-capture-tiny.xml Sat Sep
8 12:17:15 2018 (r20476)
@@ -47,9 +47,8 @@
<sect3 role="installation">
<title>Installation of Capture::Tiny</title>
- <para>
- This module uses the <xref linkend="new-perl-standard-install"/>.
- </para>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="../../../xincludes/perl-standard-install.xml"/>
</sect3>
Modified: branches/perl-modules/general/prog/perl-deps/perl-config-autoconf.xml
==============================================================================
--- branches/perl-modules/general/prog/perl-deps/perl-config-autoconf.xml
Sat Sep 8 10:41:32 2018 (r20475)
+++ branches/perl-modules/general/prog/perl-deps/perl-config-autoconf.xml
Sat Sep 8 12:17:15 2018 (r20476)
@@ -54,9 +54,8 @@
<sect3 role="installation">
<title>Installation of Config::AutoConf</title>
- <para>
- This module uses the <xref linkend="new-perl-standard-install"/>.
- </para>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="../../../xincludes/perl-standard-install.xml"/>
</sect3>
Modified:
branches/perl-modules/general/prog/perl-deps/perl-extutils-libbuilder.xml
==============================================================================
--- branches/perl-modules/general/prog/perl-deps/perl-extutils-libbuilder.xml
Sat Sep 8 10:41:32 2018 (r20475)
+++ branches/perl-modules/general/prog/perl-deps/perl-extutils-libbuilder.xml
Sat Sep 8 12:17:15 2018 (r20476)
@@ -53,9 +53,8 @@
<sect3 role="installation">
<title>Installation of ExtUtils::LibBuilder</title>
- <para>
- This module uses the <xref linkend="new-perl-build-install"/>.
- </para>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="../../../xincludes/perl-build-install.xml"/>
</sect3>
Modified: branches/perl-modules/general/prog/perl-deps/perl-sub-identify.xml
==============================================================================
--- branches/perl-modules/general/prog/perl-deps/perl-sub-identify.xml Sat Sep
8 10:41:32 2018 (r20475)
+++ branches/perl-modules/general/prog/perl-deps/perl-sub-identify.xml Sat Sep
8 12:17:15 2018 (r20476)
@@ -47,9 +47,8 @@
<sect3 role="installation">
<title>Installation of Sub::Identify</title>
- <para>
- This module uses the <xref linkend="new-perl-standard-install"/>.
- </para>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="../../../xincludes/perl-standard-install.xml"/>
</sect3>
Modified: branches/perl-modules/general/prog/perl-deps/perl-super.xml
==============================================================================
--- branches/perl-modules/general/prog/perl-deps/perl-super.xml Sat Sep 8
10:41:32 2018 (r20475)
+++ branches/perl-modules/general/prog/perl-deps/perl-super.xml Sat Sep 8
12:17:15 2018 (r20476)
@@ -54,9 +54,8 @@
<sect3 role="installation">
<title>Installation of SUPER</title>
- <para>
- This module uses the <xref linkend="new-perl-standard-install"/>.
- </para>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="../../../xincludes/perl-standard-install.xml"/>
</sect3>
Modified: branches/perl-modules/general/prog/perl-deps/perl-test-mockmodule.xml
==============================================================================
--- branches/perl-modules/general/prog/perl-deps/perl-test-mockmodule.xml
Sat Sep 8 10:41:32 2018 (r20475)
+++ branches/perl-modules/general/prog/perl-deps/perl-test-mockmodule.xml
Sat Sep 8 12:17:15 2018 (r20476)
@@ -56,9 +56,8 @@
<sect3 role="installation">
<title>Installation of Test::MockModule</title>
- <para>
- This module uses the <xref linkend="new-perl-build-install"/>.
- </para>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="../../../xincludes/perl-build-install.xml"/>
</sect3>
Modified: branches/perl-modules/general/prog/perl-deps/perl-test-warnings.xml
==============================================================================
--- branches/perl-modules/general/prog/perl-deps/perl-test-warnings.xml Sat Sep
8 10:41:32 2018 (r20475)
+++ branches/perl-modules/general/prog/perl-deps/perl-test-warnings.xml Sat Sep
8 12:17:15 2018 (r20476)
@@ -46,9 +46,8 @@
<sect3 role="installation">
<title>Installation of Test::Warnings</title>
- <para>
- This module uses the <xref linkend="new-perl-standard-install"/>.
- </para>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="../../../xincludes/perl-standard-install.xml"/>
</sect3>
Modified: branches/perl-modules/general/prog/perl-modules/perl-archive-zip.xml
==============================================================================
--- branches/perl-modules/general/prog/perl-modules/perl-archive-zip.xml
Sat Sep 8 10:41:32 2018 (r20475)
+++ branches/perl-modules/general/prog/perl-modules/perl-archive-zip.xml
Sat Sep 8 12:17:15 2018 (r20476)
@@ -54,9 +54,8 @@
<sect3 role="installation">
<title>Installation of Archive::Zip</title>
- <para>
- This module uses the <xref linkend="new-perl-standard-install"/>.
- </para>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="../../../xincludes/perl-standard-install.xml"/>
</sect3>
Modified:
branches/perl-modules/general/prog/perl-modules/perl-autovivification.xml
==============================================================================
--- branches/perl-modules/general/prog/perl-modules/perl-autovivification.xml
Sat Sep 8 10:41:32 2018 (r20475)
+++ branches/perl-modules/general/prog/perl-modules/perl-autovivification.xml
Sat Sep 8 12:17:15 2018 (r20476)
@@ -49,9 +49,8 @@
<sect3 role="installation">
<title>Installation of autovivification</title>
- <para>
- This module uses the <xref linkend="new-perl-standard-install"/>.
- </para>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="../../../xincludes/perl-standard-install.xml"/>
</sect3>
Modified: branches/perl-modules/general/prog/perl-modules/perl-business-issn.xml
==============================================================================
--- branches/perl-modules/general/prog/perl-modules/perl-business-issn.xml
Sat Sep 8 10:41:32 2018 (r20475)
+++ branches/perl-modules/general/prog/perl-modules/perl-business-issn.xml
Sat Sep 8 12:17:15 2018 (r20476)
@@ -48,9 +48,8 @@
<sect3 role="installation">
<title>Installation of Business::ISSN</title>
- <para>
- This module uses the <xref linkend="new-perl-standard-install"/>.
- </para>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="../../../xincludes/perl-standard-install.xml"/>
</sect3>
Modified: branches/perl-modules/general/prog/perl-modules/perl-module-build.xml
==============================================================================
--- branches/perl-modules/general/prog/perl-modules/perl-module-build.xml
Sat Sep 8 10:41:32 2018 (r20475)
+++ branches/perl-modules/general/prog/perl-modules/perl-module-build.xml
Sat Sep 8 12:17:15 2018 (r20476)
@@ -49,9 +49,12 @@
<sect3 role="installation">
<title>Installation of Module::Build</title>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="../../../xincludes/perl-standard-install.xml"/>
+
<para>
- This module uses the <xref linkend="new-perl-standard-install"/>,
- but it can also use the legacy <xref
linkend="new-perl-build-install"/>.
+ Note that this module can also be built using
+ <filename>Build.PL</filename>
</para>
</sect3>
Modified: branches/perl-modules/general/prog/perl-modules/perl-text-bibtex.xml
==============================================================================
--- branches/perl-modules/general/prog/perl-modules/perl-text-bibtex.xml
Sat Sep 8 10:41:32 2018 (r20475)
+++ branches/perl-modules/general/prog/perl-modules/perl-text-bibtex.xml
Sat Sep 8 12:17:15 2018 (r20476)
@@ -56,9 +56,8 @@
<sect3 role="installation">
<title>Installation of Text::BibTeX</title>
- <para>
- This module uses the <xref linkend="new-perl-build-install"/>.
- </para>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude";
+ href="../../../xincludes/perl-build-install.xml"/>
</sect3>
Added: branches/perl-modules/xincludes/perl-build-install.xml
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ branches/perl-modules/xincludes/perl-build-install.xml Sat Sep 8
12:17:15 2018 (r20476)
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; >
+
+ <!-- $LastChangedBy: bdubbs $
+ $Date: 2015-09-21 00:38:20 +0200 (lun. 21 sept. 2015) $ -->
+
+ <para>
+ This module is built using <filename>Build.PL</filename>:
+
+<screen><userinput>perl Build.PL &&
+./Build &&
+./Build test</userinput></screen>
+
+ Now, as the <systemitem class="username">root</systemitem> user~:
+
+<screen role="root"><userinput>./Build install</userinput></screen>
+
+ </para>
Added: branches/perl-modules/xincludes/perl-standard-install.xml
==============================================================================
--- /dev/null 00:00:00 1970 (empty, because file is newly added)
+++ branches/perl-modules/xincludes/perl-standard-install.xml Sat Sep 8
12:17:15 2018 (r20476)
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; >
+
+ <!-- $LastChangedBy: bdubbs $
+ $Date: 2015-09-21 00:38:20 +0200 (lun. 21 sept. 2015) $ -->
+
+ <para>
+ This module uses the standard build and installation instructions:
+
+<screen><userinput>perl Makefile.PL &&
+make &&
+make test</userinput></screen>
+
+ Now, as the <systemitem class="username">root</systemitem> user~:
+
+<screen role="root"><userinput>make install</userinput></screen>
+
+ </para>
--
http://lists.linuxfromscratch.org/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page
