From owner-svn-doc-all@FreeBSD.ORG Fri May 25 03:08:44 2012 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 3F6F71065670; Fri, 25 May 2012 03:08:44 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id 292A68FC16; Fri, 25 May 2012 03:08:44 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id q4P38irj076686; Fri, 25 May 2012 03:08:44 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.4/8.14.4/Submit) id q4P38h23076684; Fri, 25 May 2012 03:08:43 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201205250308.q4P38h23076684@svn.freebsd.org> From: Warren Block Date: Fri, 25 May 2012 03:08:43 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r38883 - head/en_US.ISO8859-1/books/porters-handbook X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.5 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: Fri, 25 May 2012 03:08:44 -0000 Author: wblock Date: Fri May 25 03:08:43 2012 New Revision: 38883 URL: http://svn.freebsd.org/changeset/doc/38883 Log: Update the Using Perl section. Some wording and markup corrections, and a rewording of the note about not using ${SITE_PERL}. Reviewed by: jgh, crees, swills Modified: head/en_US.ISO8859-1/books/porters-handbook/book.sgml Modified: head/en_US.ISO8859-1/books/porters-handbook/book.sgml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/book.sgml Fri May 25 02:32:14 2012 (r38882) +++ head/en_US.ISO8859-1/books/porters-handbook/book.sgml Fri May 25 03:08:43 2012 (r38883) @@ -5461,12 +5461,12 @@ PLIST_SUB+= NLS="@comment " - Using <literal>perl</literal> + Using <application>Perl</application> If MASTER_SITES is set to - MASTER_SITE_PERL_CPAN, then preferred value - of MASTER_SITE_SUBDIR is top-level - hierarchy name. For example, the recommend value for + MASTER_SITE_PERL_CPAN, then the preferred value + of MASTER_SITE_SUBDIR is the top-level + hierarchy name. For example, the recommended value for p5-Module-Name is Module. The top-level hierarchy can be examined at The exception to this rule is when the relevant directory - does not exist or the distfile does not exist in the + 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 both - YES and a version string, like - 5.8.0+. Using YES means - that the port can be used with all of the supported - Perl versions. If a port only + 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 minimal version (e.g. - 5.7.3+), a maximal version (e.g. - 5.8.0-) or an exact version (e.g. + 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). Variables for Ports That Use - <literal>perl</literal> + Perl Variable - Means + Meaning USE_PERL5 - Says that the port uses perl 5 + The port uses Perl 5 to build and run. USE_PERL5_BUILD - Says that the port uses perl 5 + The port uses Perl 5 to build. USE_PERL5_RUN - Says that the port uses perl 5 + The port uses Perl 5 to run. PERL - The full path of perl 5, + 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 @@ -5555,60 +5555,61 @@ PLIST_SUB+= NLS="@comment " PERL_VERSION - The full version of perl + The full version of Perl installed (e.g., 5.8.9). PERL_LEVEL - The installed perl version as + The installed Perl version as an integer of the form MNNNPP (e.g., 500809). PERL_ARCH - Where perl stores architecture + Where Perl stores architecture dependent libraries. Defaults to ${ARCH}-freebsd. PERL_PORT - Name of the perl port that is + Name of the Perl port that is installed (e.g., perl5). SITE_PERL Directory name where site specific - perl packages go. This value is - added to PLIST_SUB. + Perl packages go. This value is + added to PLIST_SUB.
- Ports of Perl modules, which do not have an official - website, should link cpan.org in the WWW - line of a pkg-descr file. The + Ports of Perl modules which do not have an official + website should link to cpan.org in the WWW + line of pkg-descr. The preferred URL form is http://search.cpan.org/dist/Module-Name/ (including the trailing slash). + - It is recommended to avoid using - ${SITE_PERL} as a dependency listing. This is - problematic because it means that - bsd.perl.mk must be included - to satisfy the dependency. Additionally, if the module's - files change, it would require changing all - dependent ports. + Do not use ${SITE_PERL} in dependency + declarations. Doing so assumes that + bsd.perl.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 + is shown in the example below. - PERL Dependency Example + Perl Dependency Example p5-IO-Tee>=0.64:${PORTSDIR}/devel/p5-IO-Tee