Changeset c93f431

Timestamp:

09/28/2018 04:43:17 AM (5 years ago)

Author:

Ken Moffat <ken@…>

Branches:

perl-modules

Children:

9a774ed1

Parents:

8857a6c

Message:

perl modules branch: If a module requires a variation of the install for scripting, such as using yes, hardcode the installation instructions and provide a command explanation.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/perl-modules@20547 af4574ff-66df-0310-9fd7-8a98e5e911e0

Files:

• general/prog/perl-deps/perl-net-ssleay.xml (modified) (1 diff)
• general/prog/perl-deps/perl-xml-sax.xml (modified) (1 diff)
• introduction/welcome/changelog.xml (modified) (1 diff)
• template/template-perl-module.xml (modified) (1 diff)

general/prog/perl-deps/perl-net-ssleay.xml

@@ -48 +48 @@
 
       <para>
-        If you are scripting, you will wish to prefix 'perl Makefile.PL' with
-        'yes "" | ' since some user input is sought.
+        This module uses a variant of the standard build and installation
+        instructions:
+
+<screen><userinput>yes 'n' perl Makefile.PL &amp;&amp;
+make             &amp;&amp;
+make test</userinput></screen>
+
+        Now, as the <systemitem class="username">root</systemitem> user:
+
+<screen role="root"><userinput>make install</userinput></screen>
+
+    </para>
+
+    </sect3>
+
+    <sect3 role="commands">
+      <title>Command Explanations</title>
+
+      <para>
+        <command>yes 'n'</command>: Perl will ask if you wish to run external
+        tests, which will fail if you do not have network connectivity. The
+        default in 'n', specifying the response allows you to script the build.
       </para>
-
-      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
-                  href="../../../xincludes/perl-standard-install.xml"/>
 
     </sect3>

general/prog/perl-deps/perl-xml-sax.xml

@@ -58 +58 @@
       <title>Installation of XML::SAX</title>
 
-      <para>
-        This module asks if you wish to allow it to alter ParserDetails.ini.
-        If you are scripting, you will wish to change 'make' to 'yes | make'.
         <!-- claimed to not support parallel building, but all it does is
          copy a few files, works with -j4 although running parallel builds
          on modules is usually not beneficial : Ken -->
+
+      <para>
+        This module uses a variant of the standard build and installation
+         instructions:
+
+<screen><userinput>yes | perl Makefile.PL &amp;&amp;
+make             &amp;&amp;
+make test</userinput></screen>
+
+        Now, as the <systemitem class="username">root</systemitem> user:
+
+<screen role="root"><userinput>make install</userinput></screen>
+
       </para>
 
-      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
-                  href="../../../xincludes/perl-standard-install.xml"/>
+    </sect3>
+
+    <sect3 role="commands">
+      <title>Command Explanations</title>
+
+      <para>
+        <command>yes</command>: Perl will ask if you want it to alter
+        ParserDetails.ini and then wait for a response. The default is
+        'y'. Using 'yes' allows you to script this.
+      </para>
 
     </sect3>

introduction/welcome/changelog.xml

@@ -44 +44 @@
 
     <listitem>
-      <para>September 29th, 2018</para>
+      <para>September 27th, 2018</para>
       <itemizedlist>
         <listitem>

template/template-perl-module.xml

@@ -75 +75 @@
                   href="../../../xincludes/perl-build-install.xml"/>
 
+<!-- Exceptionally, if a scripted build requires a value to be passed to 'yes',
+  copy the xinclude inline and add the command explanation -->
+    </sect3>
+
+    <!-- only include a command explanation if yes or similar is needed in
+       scripting -->
+    <sect3 role="commands">
+      <title>Command Explanations</title>
+
+      <para>
+        <command>yes 'n'</command>: Perl will ask if you wish to do ...
+        and will wait for a response. Using 'yes' allows you to script this.
+      </para>
+
     </sect3>