From owner-svn-doc-all@FreeBSD.ORG Mon Mar 10 18:36:39 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id B13C75A3; Mon, 10 Mar 2014 18:36:39 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 91499DD0; Mon, 10 Mar 2014 18:36:39 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s2AIadQl095292; Mon, 10 Mar 2014 18:36:39 GMT (envelope-from mat@svn.freebsd.org) Received: (from mat@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s2AIad6Y095291; Mon, 10 Mar 2014 18:36:39 GMT (envelope-from mat@svn.freebsd.org) Message-Id: <201403101836.s2AIad6Y095291@svn.freebsd.org> From: Mathieu Arnold Date: Mon, 10 Mar 2014 18:36:39 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44206 - head/en_US.ISO8859-1/books/porters-handbook/special X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 10 Mar 2014 18:36:39 -0000 Author: mat (ports committer) Date: Mon Mar 10 18:36:39 2014 New Revision: 44206 URL: http://svnweb.freebsd.org/changeset/doc/44206 Log: Update the Using Perl section. Glanced by: bjk Sponsored by: Absolight Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Mon Mar 10 13:59:51 2014 (r44205) +++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Mon Mar 10 18:36:39 2014 (r44206) @@ -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,52 +922,31 @@ 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. - - 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). + 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.) + + 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 + Read only variables + Means - 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 @@ -973,29 +956,6 @@ PLIST_SUB+= NLS="@comment " - PERL_CONFIGURE - Configure using Perl's MakeMaker. It implies - USE_PERL5. - - - - PERL_MODBUILD - Configure, build and install using Module::Build. - It implies PERL_CONFIGURE. - - - - - - - - Read only variables - Means - - - - - PERL_VERSION The full version of Perl installed (e.g., 5.8.9). @@ -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. +