Improve the Perl related sections.

Reported by:	brd
Sponsored by:	Absolight

1 files changed, 25 insertions, 42 deletions

diff --git a/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
index 182f5cfa3a..1e9a976e60 100644
--- a/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
+++ b/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
@@ -2028,48 +2028,31 @@ USE_MATE=	menus:build intlhack</programlisting>
 
     <para>Possible arguments: (none)</para>
 
-    <para>Depends on <application>Perl</application>.  These variables
-      can be set:</para>
-
-    <itemizedlist>
-      <listitem>
-	<para><varname>PERL_VERSION</varname>: Full version of
-	  <application>Perl</application> to use, or the default if
-	  not set</para>
-      </listitem>
-
-      <listitem>
-	<para><varname>PERL_ARCH</varname>: Directory name of
-	  architecture dependent libraries, defaults to
-	  <filename>mach</filename></para>
-      </listitem>
-
-      <listitem>
-	<para><varname>PERL_PORT</varname>: Name of the
-	  <application>Perl</application> port to be installed, the
-	  default is derived from
-	  <varname>PERL_VERSION</varname></para>
-      </listitem>
-
-      <listitem>
-	<para><varname>SITE_PERL</varname>: Directory name for site
-	  specific <application>Perl</application> packages</para>
-      </listitem>
-
-      <listitem>
-	<para><varname>USE_PERL5</varname>: Phases in which to use
-	  <application>Perl</application>, can be
-	  <literal>extract</literal>, <literal>patch</literal>,
-	  <literal>build</literal>, <literal>run</literal>, or
-	  <literal>test</literal>.  It can also be
-	  <literal>configure</literal>, <literal>modbuild</literal>,
-	  or <literal>modbuildtiny</literal> when
-	  <filename>Makefile.PL</filename>,
-	  <filename>Build.PL</filename>, or the Module::Build::Tiny
-	  flavor of <filename>Build.PL</filename> is required.  It
-	  defaults to <literal>build run</literal>.</para>
-      </listitem>
-    </itemizedlist>
+    <para>Depends on <application>Perl</application>.  The
+      configuration is done using <varname>USE_PERL5</varname>.</para>
+
+    <para><varname>USE_PERL5</varname> can contain the phases in which
+      to use <application>Perl</application>, can be
+      <literal>extract</literal>, <literal>patch</literal>,
+      <literal>build</literal>, <literal>run</literal>, or
+      <literal>test</literal>.</para>
+
+    <para><varname>USE_PERL5</varname> can also contain
+      <literal>configure</literal>,
+      <literal>modbuild</literal>, or <literal>modbuildtiny</literal>
+      when <filename>Makefile.PL</filename>,
+      <filename>Build.PL</filename>, or
+      <application>Module::Build::Tiny</application>'s flavor of
+      <filename>Build.PL</filename> is required.</para>
+
+    <para><varname>USE_PERL5</varname> defaults to <literal>build
+	run</literal>.  When using <literal>configure</literal>,
+      <literal>modbuild</literal>, or <literal>modbuildtiny</literal>,
+      <literal>build</literal> and <literal>run</literal> are
+      implied.</para>
+
+    <para>See <xref linkend="using-perl"/> for more
+	information.</para>
   </sect1>
 
   <sect1 xml:id="uses-pgsql">