Changeset 69c70ea for general/prog/perl-modules.xml

Timestamp:

06/07/2017 02:41:21 AM (7 years ago)

Author:

Ken Moffat <ken@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 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, 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:

c780991

Parents:

150482f

Message:

Document how to install those perl modules which still reference the current directory in @INC.

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

File:

• general/prog/perl-modules.xml (modified) (4 diffs)

general/prog/perl-modules.xml

@@ -864 +864 @@
 
     <para>The Encode::HanExtra module provides extra sets of Chinese Encodings.
-    This module uses the standard <xref linkend="perl-standard-install"/>.</para>
+    This module uses the 'unsafe' variant of the standard
+    <xref linkend="perl-standard-install"/>.</para>
 
     &lfs80_checked;
@@ -1225 +1226 @@
                 <itemizedlist>
                   <listitem> <literallayout><ulink url="http://search.cpan.org/dist/Test-LeakTrace/">Test::LeakTrace</ulink>
-(http://search.cpan.org/dist/Test-LeakTrace/) (for the testsuite)</literallayout>
+(http://search.cpan.org/dist/Test-LeakTrace/) (for the testsuite) - this uses the 'unsafe' variant of the Standard Installation</literallayout>
                   </listitem>
                 </itemizedlist>
@@ -2031 +2032 @@
 
     <para>
-      Unicode::Collate provides a Unicode collation algorithm. This is a core
-      perl module, but <xref linkend="biber"/> needs a newer version.
-      This module uses the standard
+      Unicode::Collate provides a Unicode collation algorithm.
+      This module uses the 'unsafe' variant of the standard
       <xref linkend="perl-standard-install"/>.
     </para>
@@ -2371 +2371 @@
 make &amp;&amp;
 make test</userinput></screen>
+
+    <note>
+      <para>If the module is described as using the <emphasis>unsafe</emphasis>
+      variant of the Standard Installation, and you are using
+      <application>perl-5.26.0</application> or later, (the use of the current
+      directory in <literal>@INC</literal> was removed for security reasons)
+      you should change the perl invocation to:</para>
+
+<screen><userinput>PERL_USE_UNSAFE_INC=1 &amp;&amp;</userinput></screen>
+
+      <para>If, however, you are using the Auto Installation described below,
+      that environment variable will be set whenever the <command>cpan</command>
+      shell <command>install</command> is used.</para>
+    </note>
 
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>