pkg/46981: Document configuration phase of packages that use Makefile.PL in pkgsrc guide

[silasdb%gmail.com@localhost]

>Number:         46981
>Category:       pkg
>Synopsis:       Document configuration phase of packages that use Makefile.PL 
>in pkgsrc guide
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    pkg-manager
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue Sep 18 15:30:00 +0000 2012
>Originator:     Silas Silva
>Release:        NetBSD 5.1
>Organization:
>Environment:
System: NetBSD auron.ufabc.int.br 5.1 NetBSD 5.1 (GENERIC) #0: Sun Nov 7 
14:39:56 UTC 2010 
builds%b6.netbsd.org@localhost:/home/builds/ab/netbsd-5-1-RELEASE/i386/201011061943Z-obj/home/builds/ab/netbsd-5-1-RELEASE/src/sys/arch/i386/compile/GENERIC
 i386
Architecture: i386
Machine: i386
>Description:
Configuration phase for different kind of packages and build techniques is
documented, but not Makefile.PL.  Patch below suggests a paragraph to be
included in the pkgsrc guide to fix this problem.
>How-To-Repeat:
>Fix:
Apply this patch or something like that:

Index: build.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/build.xml,v
retrieving revision 1.63
diff -u -p -r1.63 build.xml
--- build.xml   4 Aug 2011 13:50:07 -0000       1.63
+++ build.xml   18 Sep 2012 15:10:03 -0000
@@ -590,6 +590,13 @@ ${FETCH_CMD} ${FETCH_BEFORE_ARGS} ${site
     <varname>CONFIGURE_ARGS</varname> may all be changed by the
     package.</para>
 
+    <para>If the program uses the Perl way of configuration (mainly Perl
+    modules, but not only), i.e. a file called
+    <filename>Makefile.PL</filename>, it should include
+    <filename>../../lang/perl5/module.mk</filename>. To set any parameter for
+    <filename>Makefile.PL</filename> use the <varname>MAKE_PARAMS</varname>
+    variable (e.g., <literal>MAKE_PARAMS+=foo=bar</literal></para>
+
     <para>If the program uses an <filename>Imakefile</filename>
     for configuration, the appropriate steps can be invoked by
     setting <varname>USE_IMAKE</varname> to