From owner-freebsd-perl@FreeBSD.ORG Wed May 23 20:39:07 2012 Return-Path: Delivered-To: perl@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 6110E106564A; Wed, 23 May 2012 20:39:07 +0000 (UTC) (envelope-from utisoft@gmail.com) Received: from mail-bk0-f54.google.com (mail-bk0-f54.google.com [209.85.214.54]) by mx1.freebsd.org (Postfix) with ESMTP id 540158FC12; Wed, 23 May 2012 20:39:05 +0000 (UTC) Received: by bkvi18 with SMTP id i18so8584410bkv.13 for ; Wed, 23 May 2012 13:39:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:from:date :x-google-sender-auth:message-id:subject:to:cc:content-type :content-transfer-encoding; bh=a7RVFvllzykEh1v7L6Y9f5/zlb534FazevblM/MIzWE=; b=dlnDBNclWjjbJQ8ZjILSvhRKiowQI5u/bCRAcPiEnuOvOx2P66YLpn1niCEq/6R+3D vEp7929Ac+MVvwGnQVAyu8iUMHgIpjpeEwg/TCTYtFm5Tl13/tvwBmKxvXncmxxFHhPA 30RFswktKg/jSs+S3bT1jOVgLde2Ap+OFiyoPbNwP6sRBRo9TyoEn/96HF+oCfA33aZj 214Ptuxd4sDRCc4nhcKUo5auPtjyBnpV2H42loT2geDGyUwN9v++n4RXyFnngNPx1AGp W5PbN42dF6mmp4T53DekcedlnyX+wuvo8nHTibIoI8IKAS68Y+VYNITA59WXh4U5IjpH oivA== Received: by 10.204.152.196 with SMTP id h4mr12880512bkw.131.1337805544379; Wed, 23 May 2012 13:39:04 -0700 (PDT) MIME-Version: 1.0 Sender: utisoft@gmail.com Received: by 10.204.171.138 with HTTP; Wed, 23 May 2012 13:38:34 -0700 (PDT) In-Reply-To: References: From: Chris Rees Date: Wed, 23 May 2012 21:38:34 +0100 X-Google-Sender-Auth: BVdimT-7v-AOw53TDGsiBVAv8ag Message-ID: To: Warren Block Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Cc: swills@freebsd.org, perl , wblock@freebsd.org, jgh@freebsd.org Subject: Re: Porter's Handbook Perl section update X-BeenThere: freebsd-perl@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: maintainer of a number of perl-related ports List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 23 May 2012 20:39:07 -0000 On 23 May 2012 21:25, Warren Block wrote: > On Wed, 23 May 2012, Chris Rees wrote: > >> On 23 May 2012 18:11, Warren Block wrote: >>> >>> The second note in the Using perl section of the Porter's Handbook was >>> unclear to me: >>> >>> =A0Note: It is recommended to avoid using ${SITE_PERL} as a dependency >>> =A0listing. This is problematic because it means that bsd.perl.mk must = be >>> =A0included to satisfy the dependency. Additionally, if the module's fi= les >>> =A0change, it would require changing all dependent ports. >>> >>> After some talking with jgh@, I've suggested this: >>> >>> =A0Do not use ${SITE_PERL} in dependency declarations. =A0Doing so >>> =A0assumes that bsd.perl.mk has been included, which is not always true= . >>> =A0Ports depending on this port will have incorrect dependencies if thi= s >>> =A0port's files move later in an upgrade. =A0The right way to declare P= erl >>> =A0module dependencies is shown in the example below. >>> >>> The second sentence is a little weak, but overall this makes much more >>> sense, to me at least. =A0If this looks okay, I'd like to update the >>> Porter's >>> Handbook. >> >> >> [adding perl@] >> >> Please! > > > (Taking that as "please go ahead" rather than "please go away".) > > The attached diff replaces that note, cleans up some use of commas and mi= nor > wording, and removes tags around "Perl" when talking about the > language rather than the specific interpreter. Capitalization is also > changed as in > http://learn.perl.org/faq/perlfaq1.html#Whats-the-difference-between-perl= -and-Perl- > > I tried this with tags around every instance of Perl, and > reading it was like listening to someone who Pronounces Capitals. =A0One = use > of in the title seems adequate. Looks great to me. Personally I would not have minded loads of s, but that's just= me. Chris