From owner-freebsd-perl@FreeBSD.ORG Wed May 23 21:26:06 2012 Return-Path: Delivered-To: perl@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 193641065670 for ; Wed, 23 May 2012 21:26:06 +0000 (UTC) (envelope-from bsd-src@helfman.org) Received: from mail-pb0-f54.google.com (mail-pb0-f54.google.com [209.85.160.54]) by mx1.freebsd.org (Postfix) with ESMTP id D0C138FC0C for ; Wed, 23 May 2012 21:26:05 +0000 (UTC) Received: by pbbro2 with SMTP id ro2so11313539pbb.13 for ; Wed, 23 May 2012 14:26:05 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=sender:date:from:to:cc:subject:message-id:references:mime-version :content-type:content-disposition:content-transfer-encoding :in-reply-to:x-operating-system:organization:x-living-the-dream :x-pgp-fingerprint:x-pgp-key:user-agent:x-gm-message-state; bh=ZMyMQVjjIZY9ku1fBbgUd+t4jem1NNHeNvoWG+E28g4=; b=bsDyfCgU6/XQ/5qP1r/zSIcZjcQ6Ohfu+oiPPaWKDguiBVQeV+pXL3jRcAd0GCX2d5 f96qG6QZsV0IFLBaGKgpiUuEgL5jgMpME0JyJU7ZJQmglqunz6RCcU+UYQGdFwUS3kUB apMr0xaxQUK1XX5D75DOJ1SseqoBwfYghWmMJ5w4/8rNaVkn8V50ajY7AwDV5X/HsiiM 6ZSKhwTi9jEFdOoazlZVfgCyJEtSXovpHEG0JAcL65bZNEwdMupmkUiuQj58MZEH7hXU NPg1jukdEoelSssJaR7YHk5+iJH7VDe+eZsqhOsirKOfRJyH06Orh2NjyP6/TcwfTtO/ KOQw== Received: by 10.68.238.135 with SMTP id vk7mr14086715pbc.134.1337808365288; Wed, 23 May 2012 14:26:05 -0700 (PDT) Received: from dormouse.experts-exchange.com ([72.29.164.238]) by mx.google.com with ESMTPS id kd6sm3039180pbc.24.2012.05.23.14.26.03 (version=TLSv1/SSLv3 cipher=OTHER); Wed, 23 May 2012 14:26:04 -0700 (PDT) Sender: Jason Helfman Date: Wed, 23 May 2012 14:24:43 -0700 From: Jason Helfman To: Chris Rees Message-ID: <20120523212443.GB40013@dormouse.experts-exchange.com> References: MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1; format=flowed Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: X-Operating-System: FreeBSD 8.3-RELEASE amd64 Organization: The FreeBSD Project, http://www.freebsd.org X-Living-The-Dream: I love the SLO Life! X-PGP-FingerPrint: 8E0D C457 9A0F C91C 23F3 0454 2059 9A63 4150 D3DC X-PGP-Key: http://people.freebsd.org/~jgh/jgh.asc User-Agent: Mutt/1.5.21 (2010-09-15) X-Gm-Message-State: ALoCoQnozzfs3dH16pTGirSNSxJAINGRiazQsEJ1kWZQ8SiMHuGBGO7xeS7N4Vnh+WPLhHB0umiW Cc: Warren Block , swills@freebsd.org, perl , wblock@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 21:26:06 -0000 On Wed, May 23, 2012 at 09:38:34PM +0100, Chris Rees thus spake: >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: >>>> >>>>  Note: 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. >>>> >>>> After some talking with jgh@, I've suggested this: >>>> >>>>  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. >>>> >>>> The second sentence is a little weak, but overall this makes much more >>>> sense, to me at least.  If 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 minor >> 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.  One 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 > Looks great to me, as well. I still ascertain that "the" is one of the most overused and unneeded words in the English language. Yes, I've used it twice in the previous sentence, but most sentences can do without it :) -jgh -- Jason Helfman FreeBSD Committer | http://people.freebsd.org/~jgh | The Power To Serve