From 8c3d42d2c937bdb202c1cb39f2899088cd243005 Mon Sep 17 00:00:00 2001 From: Mathieu Arnold Date: Mon, 10 Mar 2014 18:36:39 +0000 Subject: [PATCH] Update the Using Perl section. Glanced by: bjk Sponsored by: Absolight --- .../porters-handbook/special/chapter.xml | 100 ++++++------------ 1 file changed, 33 insertions(+), 67 deletions(-) diff --git a/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml b/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml index c7e993fab3..8c7fc8e9ac 100644 --- a/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml +++ b/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml @@ -905,6 +905,10 @@ PLIST_SUB+= NLS="@comment " Using <application>Perl</application> If MASTER_SITES is set to + CPAN, the correct subdirectory should be + selected automatically. If the default subdirectory is wrong, + CPAN/Module can be used to change it. + MASTER_SITES can also be set to the old MASTER_SITE_PERL_CPAN, then the preferred value of MASTER_SITE_SUBDIR is the top-level hierarchy name. For example, the recommended value @@ -918,74 +922,21 @@ PLIST_SUB+= NLS="@comment " The exception to this rule is when the relevant directory does not exist or the distfile does not exist in that directory. In such case, using author's id as - MASTER_SITE_SUBDIR is allowed. + MASTER_SITE_SUBDIR is allowed. + The CPAN:AUTHOR macro can be used, which will + be translated to the hashed author directory. (e.g., + CPAN:AUTHOR will be converted to + authors/id/A/AU/AUTHOR.) - All of the tunable knobs below accept either - YES or a version string like - 5.8.0+. YES means - that the port can be used with any of the supported - Perl versions. If a port only - works with specific versions of - Perl, it can be indicated with a - version string, specifying a minimum version (e.g., - 5.7.3+), a maximum version (e.g., - 5.8.0-) or an exact version (e.g., - 5.8.3). + When a port needs Perl support, + it should use USES=perl5 with the optional + USE_PERL5 like described in the perl5 USES description. - Variables for Ports That Use + <title>Read-Only Variables for Ports That Use <application>Perl</application> - - - - Variable - Meaning - - - - - - USE_PERL5 - The port uses Perl 5 - to build and run. - - - - USE_PERL5_BUILD - The port uses Perl 5 - to build. - - - - USE_PERL5_RUN - The port uses Perl 5 - to run. - - - - PERL - The full path of the Perl 5 interpreter, - either in the system or installed from a port, but - without the version number. Use this if you need to - replace #!lines in - scripts. - - - - PERL_CONFIGURE - Configure using Perl's MakeMaker. It implies - USE_PERL5. - - - - PERL_MODBUILD - Configure, build and install using Module::Build. - It implies PERL_CONFIGURE. - - - - @@ -995,6 +946,15 @@ PLIST_SUB+= NLS="@comment " + + PERL + The full path of the Perl 5 interpreter, + either in the system or installed from a port, but + without the version number. Use this if you need to + replace #!lines in + scripts. + + PERL_VERSION The full version of Perl @@ -1043,7 +1003,7 @@ PLIST_SUB+= NLS="@comment " Do not use ${SITE_PERL} in dependency declarations. Doing so assumes that - bsd.perl.mk has been included, which is + perl5.mk has been included, which is not always true. Ports depending on this port will have incorrect dependencies if this port's files move later in an upgrade. The right way to declare Perl module dependencies @@ -1057,9 +1017,7 @@ PLIST_SUB+= NLS="@comment " For Perl ports that install manual pages, the macro - PERL5_MANx - (where x ranges from - 1 to 9) can be used + PERL5_MAN3 can be used inside pkg-plist. For example, lib/perl5/5.14/man/man3/AnyEvent::I3.3.gz @@ -1067,6 +1025,14 @@ PLIST_SUB+= NLS="@comment " can be replaced with %%PERL5_MAN3%%/AnyEvent::I3.3.gz + + + There are no PERL5_MANx macros for the + other sections (x in + 1, 2 and + 4 to 9) because those + get installed in the regular directories. +