Date: Wed, 23 May 2012 14:25:17 -0600 (MDT) From: Warren Block <wblock@wonkity.com> To: Chris Rees <crees@FreeBSD.org> Cc: swills@FreeBSD.org, perl <perl@FreeBSD.org>, wblock@FreeBSD.org, jgh@FreeBSD.org Subject: Re: Porter's Handbook Perl section update Message-ID: <alpine.BSF.2.00.1205231414180.49763@wonkity.com> In-Reply-To: <CADLo83_2ax9GR7%2Bf7U593B%2BPQxjpFzP_f5_VsjwzRdoZUQ%2BBMQ@mail.gmail.com> References: <alpine.BSF.2.00.1205231101410.48694@wonkity.com> <CADLo83_2ax9GR7%2Bf7U593B%2BPQxjpFzP_f5_VsjwzRdoZUQ%2BBMQ@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
This message is in MIME format. The first part should be readable text,
while the remaining parts are likely unreadable without MIME-aware tools.
---902635197-1945249235-1337804717=:49763
Content-Type: TEXT/PLAIN; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 8BIT
On Wed, 23 May 2012, Chris Rees wrote:
> On 23 May 2012 18:11, Warren Block <wblock@wonkity.com> 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 <literal> 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 <application> tags around every instance of Perl, and
reading it was like listening to someone who Pronounces Capitals. One
use of <application> in the title seems adequate.
Feedback welcome. Thanks!
---902635197-1945249235-1337804717=:49763
Content-Type: TEXT/PLAIN; charset=US-ASCII; name=patch-porters-perl.diff
Content-Transfer-Encoding: BASE64
Content-ID: <alpine.BSF.2.00.1205231425170.49763@wonkity.com>
Content-Description:
Content-Disposition: attachment; filename=patch-porters-perl.diff
SW5kZXg6IGRvYy9lbl9VUy5JU084ODU5LTEvYm9va3MvcG9ydGVycy1oYW5k
Ym9vay9ib29rLnNnbWwNCj09PT09PT09PT09PT09PT09PT09PT09PT09PT09
PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCi0tLSBk
b2MvZW5fVVMuSVNPODg1OS0xL2Jvb2tzL3BvcnRlcnMtaGFuZGJvb2svYm9v
ay5zZ21sCShyZXZpc2lvbiAzODg3NikNCisrKyBkb2MvZW5fVVMuSVNPODg1
OS0xL2Jvb2tzL3BvcnRlcnMtaGFuZGJvb2svYm9vay5zZ21sCSh3b3JraW5n
IGNvcHkpDQpAQCAtNTQ2MSwxMSArNTQ2MSwxMSBAQA0KICAgICA8L3NlY3Qx
Pg0KIA0KICAgICA8c2VjdDEgaWQ9InVzaW5nLXBlcmwiPg0KLSAgICAgIDx0
aXRsZT5Vc2luZyA8bGl0ZXJhbD5wZXJsPC9saXRlcmFsPjwvdGl0bGU+DQor
ICAgICAgPHRpdGxlPlVzaW5nIDxhcHBsaWNhdGlvbj5QZXJsPC9hcHBsaWNh
dGlvbj48L3RpdGxlPg0KIA0KICAgICAgIDxwYXJhPklmIDxtYWtldmFyPk1B
U1RFUl9TSVRFUzwvbWFrZXZhcj4gaXMgc2V0IHRvDQotCTxtYWtldmFyPk1B
U1RFUl9TSVRFX1BFUkxfQ1BBTjwvbWFrZXZhcj4sIHRoZW4gcHJlZmVycmVk
IHZhbHVlDQotCW9mIDxtYWtldmFyPk1BU1RFUl9TSVRFX1NVQkRJUjwvbWFr
ZXZhcj4gaXMgdG9wLWxldmVsDQorCTxtYWtldmFyPk1BU1RFUl9TSVRFX1BF
UkxfQ1BBTjwvbWFrZXZhcj4sIHRoZW4gdGhlIHByZWZlcnJlZCB2YWx1ZQ0K
KwlvZiA8bWFrZXZhcj5NQVNURVJfU0lURV9TVUJESVI8L21ha2V2YXI+IGlz
IHRoZSB0b3AtbGV2ZWwNCiAJaGllcmFyY2h5IG5hbWUuICBGb3IgZXhhbXBs
ZSwgdGhlIHJlY29tbWVuZCB2YWx1ZSBmb3INCiAJPGxpdGVyYWw+cDUtTW9k
dWxlLU5hbWU8L2xpdGVyYWw+IGlzDQogCTxsaXRlcmFsPk1vZHVsZTwvbGl0
ZXJhbD4uICBUaGUgdG9wLWxldmVsIGhpZXJhcmNoeSBjYW4gYmUNCkBAIC01
NDc1LDU2ICs1NDc1LDU2IEBADQogCWNoYW5nZXMuPC9wYXJhPg0KIA0KICAg
ICAgIDxwYXJhPlRoZSBleGNlcHRpb24gdG8gdGhpcyBydWxlIGlzIHdoZW4g
dGhlIHJlbGV2YW50IGRpcmVjdG9yeQ0KLQlkb2VzIG5vdCBleGlzdCBvciB0
aGUgZGlzdGZpbGUgZG9lcyBub3QgZXhpc3QgaW4gdGhlDQorCWRvZXMgbm90
IGV4aXN0IG9yIHRoZSBkaXN0ZmlsZSBkb2VzIG5vdCBleGlzdCBpbiB0aGF0
DQogCWRpcmVjdG9yeS4gIEluIHN1Y2ggY2FzZSwgdXNpbmcgYXV0aG9yJ3Mg
aWQgYXMNCiAJPG1ha2V2YXI+TUFTVEVSX1NJVEVfU1VCRElSPC9tYWtldmFy
PiBpcyBhbGxvd2VkLjwvcGFyYT4NCiANCi0gICAgICA8cGFyYT5BbGwgb2Yg
dGhlIHR1bmFibGUga25vYnMgYmVsb3cgYWNjZXB0IGJvdGgNCi0JPGxpdGVy
YWw+WUVTPC9saXRlcmFsPiBhbmQgYSB2ZXJzaW9uIHN0cmluZywgbGlrZQ0K
LQk8bGl0ZXJhbD41LjguMCs8L2xpdGVyYWw+LiAgVXNpbmcgPGxpdGVyYWw+
WUVTPC9saXRlcmFsPiBtZWFucw0KLQl0aGF0IHRoZSBwb3J0IGNhbiBiZSB1
c2VkIHdpdGggYWxsIG9mIHRoZSBzdXBwb3J0ZWQNCi0JPGFwcGxpY2F0aW9u
PlBlcmw8L2FwcGxpY2F0aW9uPiB2ZXJzaW9ucy4gIElmIGEgcG9ydCBvbmx5
DQorICAgICAgPHBhcmE+QWxsIG9mIHRoZSB0dW5hYmxlIGtub2JzIGJlbG93
IGFjY2VwdCBlaXRoZXINCisJPGxpdGVyYWw+WUVTPC9saXRlcmFsPiBvciBh
IHZlcnNpb24gc3RyaW5nIGxpa2UNCisJPGxpdGVyYWw+NS44LjArPC9saXRl
cmFsPi4gIDxsaXRlcmFsPllFUzwvbGl0ZXJhbD4gbWVhbnMNCisJdGhhdCB0
aGUgcG9ydCBjYW4gYmUgdXNlZCB3aXRoIGFueSBvZiB0aGUgc3VwcG9ydGVk
DQorCVBlcmwgdmVyc2lvbnMuICBJZiBhIHBvcnQgb25seQ0KIAl3b3JrcyB3
aXRoIHNwZWNpZmljIHZlcnNpb25zIG9mDQotCTxhcHBsaWNhdGlvbj5QZXJs
PC9hcHBsaWNhdGlvbj4sIGl0IGNhbiBiZSBpbmRpY2F0ZWQgd2l0aCBhDQot
CXZlcnNpb24gc3RyaW5nLCBzcGVjaWZ5aW5nIGEgbWluaW1hbCB2ZXJzaW9u
IChlLmcuDQotCTxsaXRlcmFsPjUuNy4zKzwvbGl0ZXJhbD4pLCBhIG1heGlt
YWwgdmVyc2lvbiAoZS5nLg0KLQk8bGl0ZXJhbD41LjguMC08L2xpdGVyYWw+
KSBvciBhbiBleGFjdCB2ZXJzaW9uIChlLmcuDQorCVBlcmwsIGl0IGNhbiBi
ZSBpbmRpY2F0ZWQgd2l0aCBhDQorCXZlcnNpb24gc3RyaW5nLCBzcGVjaWZ5
aW5nIGEgbWluaW11bSB2ZXJzaW9uIChlLmcuLA0KKwk8bGl0ZXJhbD41Ljcu
Mys8L2xpdGVyYWw+KSwgYSBtYXhpbXVtIHZlcnNpb24gKGUuZy4sDQorCTxs
aXRlcmFsPjUuOC4wLTwvbGl0ZXJhbD4pIG9yIGFuIGV4YWN0IHZlcnNpb24g
KGUuZy4sDQogCTxsaXRlcmFsPjUuOC4zPC9saXRlcmFsPikuPC9wYXJhPg0K
IA0KICAgICAgIDx0YWJsZSBmcmFtZT0ibm9uZSI+DQogCTx0aXRsZT5WYXJp
YWJsZXMgZm9yIFBvcnRzIFRoYXQgVXNlDQotCSAgPGxpdGVyYWw+cGVybDwv
bGl0ZXJhbD48L3RpdGxlPg0KKwkgIDxhcHBsaWNhdGlvbj5QZXJsPC9hcHBs
aWNhdGlvbj48L3RpdGxlPg0KIA0KIAk8dGdyb3VwIGNvbHM9IjIiPg0KIAkg
IDx0aGVhZD4NCiAJICAgIDxyb3c+DQogCSAgICAgIDxlbnRyeT5WYXJpYWJs
ZTwvZW50cnk+DQotCSAgICAgIDxlbnRyeT5NZWFuczwvZW50cnk+DQorCSAg
ICAgIDxlbnRyeT5NZWFuaW5nPC9lbnRyeT4NCiAJICAgIDwvcm93Pg0KIAkg
IDwvdGhlYWQ+DQogDQogCSAgPHRib2R5Pg0KIAkgICAgPHJvdz4NCiAJICAg
ICAgPGVudHJ5PjxtYWtldmFyPlVTRV9QRVJMNTwvbWFrZXZhcj48L2VudHJ5
Pg0KLQkgICAgICA8ZW50cnk+U2F5cyB0aGF0IHRoZSBwb3J0IHVzZXMgPGxp
dGVyYWw+cGVybCA1PC9saXRlcmFsPg0KKwkgICAgICA8ZW50cnk+VGhlIHBv
cnQgdXNlcyBQZXJsIDUNCiAJCXRvIGJ1aWxkIGFuZCBydW4uPC9lbnRyeT4N
CiAJICAgIDwvcm93Pg0KIA0KIAkgICAgPHJvdz4NCiAJICAgICAgPGVudHJ5
PjxtYWtldmFyPlVTRV9QRVJMNV9CVUlMRDwvbWFrZXZhcj48L2VudHJ5Pg0K
LQkgICAgICA8ZW50cnk+U2F5cyB0aGF0IHRoZSBwb3J0IHVzZXMgPGxpdGVy
YWw+cGVybCA1PC9saXRlcmFsPg0KKwkgICAgICA8ZW50cnk+VGhlIHBvcnQg
dXNlcyBQZXJsIDUNCiAJCXRvIGJ1aWxkLjwvZW50cnk+DQogCSAgICA8L3Jv
dz4NCiANCiAJICAgIDxyb3c+DQogCSAgICAgIDxlbnRyeT48bWFrZXZhcj5V
U0VfUEVSTDVfUlVOPC9tYWtldmFyPjwvZW50cnk+DQotCSAgICAgIDxlbnRy
eT5TYXlzIHRoYXQgdGhlIHBvcnQgdXNlcyA8bGl0ZXJhbD5wZXJsIDU8L2xp
dGVyYWw+DQorCSAgICAgIDxlbnRyeT5UaGUgcG9ydCB1c2VzIFBlcmwgNQ0K
IAkJdG8gcnVuLjwvZW50cnk+DQogCSAgICA8L3Jvdz4NCiANCiAJICAgIDxy
b3c+DQogCSAgICAgIDxlbnRyeT48bWFrZXZhcj5QRVJMPC9tYWtldmFyPjwv
ZW50cnk+DQotCSAgICAgIDxlbnRyeT5UaGUgZnVsbCBwYXRoIG9mIDxsaXRl
cmFsPnBlcmwgNTwvbGl0ZXJhbD4sDQorCSAgICAgIDxlbnRyeT5UaGUgZnVs
bCBwYXRoIG9mIHRoZSBQZXJsIDUgaW50ZXJwcmV0ZXIsDQogCQllaXRoZXIg
aW4gdGhlIHN5c3RlbSBvciBpbnN0YWxsZWQgZnJvbSBhIHBvcnQsIGJ1dA0K
IAkJd2l0aG91dCB0aGUgdmVyc2lvbiBudW1iZXIuICBVc2UgdGhpcyBpZiB5
b3UgbmVlZCB0bw0KIAkJcmVwbGFjZSA8cXVvdGU+PGxpdGVyYWw+IyE8L2xp
dGVyYWw+PC9xdW90ZT5saW5lcyBpbg0KQEAgLTU1NTUsNjAgKzU1NTUsNjEg
QEANCiAJICA8dGJvZHk+DQogCSAgICA8cm93Pg0KIAkgICAgICA8ZW50cnk+
PG1ha2V2YXI+UEVSTF9WRVJTSU9OPC9tYWtldmFyPjwvZW50cnk+DQotCSAg
ICAgIDxlbnRyeT5UaGUgZnVsbCB2ZXJzaW9uIG9mIDxsaXRlcmFsPnBlcmw8
L2xpdGVyYWw+DQorCSAgICAgIDxlbnRyeT5UaGUgZnVsbCB2ZXJzaW9uIG9m
IFBlcmwNCiAJCWluc3RhbGxlZCAoZS5nLiwgPGxpdGVyYWw+NS44Ljk8L2xp
dGVyYWw+KS48L2VudHJ5Pg0KIAkgICAgPC9yb3c+DQogDQogCSAgICA8cm93
Pg0KIAkgICAgICA8ZW50cnk+PG1ha2V2YXI+UEVSTF9MRVZFTDwvbWFrZXZh
cj48L2VudHJ5Pg0KLQkgICAgICA8ZW50cnk+VGhlIGluc3RhbGxlZCA8bGl0
ZXJhbD5wZXJsPC9saXRlcmFsPiB2ZXJzaW9uIGFzDQorCSAgICAgIDxlbnRy
eT5UaGUgaW5zdGFsbGVkIFBlcmwgdmVyc2lvbiBhcw0KIAkJYW4gaW50ZWdl
ciBvZiB0aGUgZm9ybSA8bGl0ZXJhbD5NTk5OUFA8L2xpdGVyYWw+DQogCQko
ZS5nLiwgPGxpdGVyYWw+NTAwODA5PC9saXRlcmFsPikuPC9lbnRyeT4NCiAJ
ICAgIDwvcm93Pg0KIA0KIAkgICAgPHJvdz4NCiAJICAgICAgPGVudHJ5Pjxt
YWtldmFyPlBFUkxfQVJDSDwvbWFrZXZhcj48L2VudHJ5Pg0KLQkgICAgICA8
ZW50cnk+V2hlcmUgPGxpdGVyYWw+cGVybDwvbGl0ZXJhbD4gc3RvcmVzIGFy
Y2hpdGVjdHVyZQ0KKwkgICAgICA8ZW50cnk+V2hlcmUgUGVybCBzdG9yZXMg
YXJjaGl0ZWN0dXJlDQogCQlkZXBlbmRlbnQgbGlicmFyaWVzLiAgRGVmYXVs
dHMgdG8NCiAJCTxsaXRlcmFsPiR7QVJDSH0tZnJlZWJzZDwvbGl0ZXJhbD4u
PC9lbnRyeT4NCiAJICAgIDwvcm93Pg0KIA0KIAkgICAgPHJvdz4NCiAJICAg
ICAgPGVudHJ5PjxtYWtldmFyPlBFUkxfUE9SVDwvbWFrZXZhcj48L2VudHJ5
Pg0KLQkgICAgICA8ZW50cnk+TmFtZSBvZiB0aGUgPGxpdGVyYWw+cGVybDwv
bGl0ZXJhbD4gcG9ydCB0aGF0IGlzDQorCSAgICAgIDxlbnRyeT5OYW1lIG9m
IHRoZSBQZXJsIHBvcnQgdGhhdCBpcw0KIAkJaW5zdGFsbGVkIChlLmcuLCA8
bGl0ZXJhbD5wZXJsNTwvbGl0ZXJhbD4pLjwvZW50cnk+DQogCSAgICA8L3Jv
dz4NCiANCiAJICAgIDxyb3c+DQogCSAgICAgIDxlbnRyeT48bWFrZXZhcj5T
SVRFX1BFUkw8L21ha2V2YXI+PC9lbnRyeT4NCiAJICAgICAgPGVudHJ5PkRp
cmVjdG9yeSBuYW1lIHdoZXJlIHNpdGUgc3BlY2lmaWMNCi0JCTxsaXRlcmFs
PnBlcmw8L2xpdGVyYWw+IHBhY2thZ2VzIGdvLiAgVGhpcyB2YWx1ZSBpcw0K
LQkJYWRkZWQgdG8gUExJU1RfU1VCLjwvZW50cnk+DQorCQlQZXJsIHBhY2th
Z2VzIGdvLiAgVGhpcyB2YWx1ZSBpcw0KKwkJYWRkZWQgdG8gPG1ha2V2YXI+
UExJU1RfU1VCPC9tYWtldmFyPi48L2VudHJ5Pg0KIAkgICAgPC9yb3c+DQog
CSAgPC90Ym9keT4NCiAJPC90Z3JvdXA+DQogICAgICAgPC90YWJsZT4NCiAN
CiAgICAgICA8bm90ZT4NCi0JPHBhcmE+UG9ydHMgb2YgUGVybCBtb2R1bGVz
LCB3aGljaCBkbyBub3QgaGF2ZSBhbiBvZmZpY2lhbA0KLQkgIHdlYnNpdGUs
IHNob3VsZCBsaW5rIDxob3N0aWQ+Y3Bhbi5vcmc8L2hvc3RpZD4gaW4gdGhl
IFdXVw0KLQkgIGxpbmUgb2YgYSA8ZmlsZW5hbWU+cGtnLWRlc2NyPC9maWxl
bmFtZT4gZmlsZS4gIFRoZQ0KKwk8cGFyYT5Qb3J0cyBvZiBQZXJsIG1vZHVs
ZXMgd2hpY2ggZG8gbm90IGhhdmUgYW4gb2ZmaWNpYWwNCisJICB3ZWJzaXRl
IHNob3VsZCBsaW5rIHRvIDxob3N0aWQ+Y3Bhbi5vcmc8L2hvc3RpZD4gaW4g
dGhlIFdXVw0KKwkgIGxpbmUgb2YgPGZpbGVuYW1lPnBrZy1kZXNjcjwvZmls
ZW5hbWU+LiAgVGhlDQogCSAgcHJlZmVycmVkIFVSTCBmb3JtIGlzDQogCSAg
PGxpdGVyYWw+aHR0cDovL3NlYXJjaC5jcGFuLm9yZy9kaXN0L01vZHVsZS1O
YW1lLzwvbGl0ZXJhbD4NCiAJICAoaW5jbHVkaW5nIHRoZSB0cmFpbGluZyBz
bGFzaCkuPC9wYXJhPg0KICAgICAgIDwvbm90ZT4NCisNCiAgICAgICA8bm90
ZT4NCi0JPHBhcmE+SXQgaXMgcmVjb21tZW5kZWQgdG8gYXZvaWQgdXNpbmcg
PGxpdGVyYWw+DQotCSAgICAke1NJVEVfUEVSTH08L2xpdGVyYWw+IGFzIGEg
ZGVwZW5kZW5jeSBsaXN0aW5nLiAgVGhpcyBpcw0KLQkgIHByb2JsZW1hdGlj
IGJlY2F1c2UgaXQgbWVhbnMgdGhhdA0KLQkgIDxmaWxlbmFtZT5ic2QucGVy
bC5tazwvZmlsZW5hbWU+IG11c3QgYmUgaW5jbHVkZWQNCi0JICB0byBzYXRp
c2Z5IHRoZSBkZXBlbmRlbmN5LiAgQWRkaXRpb25hbGx5LCBpZiB0aGUgbW9k
dWxlJ3MNCi0JICBmaWxlcyBjaGFuZ2UsIGl0IHdvdWxkIHJlcXVpcmUgY2hh
bmdpbmcgYWxsDQotCSAgZGVwZW5kZW50IHBvcnRzLjwvcGFyYT4NCisJPHBh
cmE+RG8gbm90IHVzZSA8bGl0ZXJhbD4ke1NJVEVfUEVSTH08L2xpdGVyYWw+
IGluIGRlcGVuZGVuY3kNCisJICBkZWNsYXJhdGlvbnMuICBEb2luZyBzbyBh
c3N1bWVzIHRoYXQNCisJICA8ZmlsZW5hbWU+YnNkLnBlcmwubWs8L2ZpbGVu
YW1lPiBoYXMgYmVlbiBpbmNsdWRlZCwgd2hpY2ggaXMNCisJICBub3QgYWx3
YXlzIHRydWUuICBQb3J0cyBkZXBlbmRpbmcgb24gdGhpcyBwb3J0IHdpbGwg
aGF2ZQ0KKwkgIGluY29ycmVjdCBkZXBlbmRlbmNpZXMgaWYgdGhpcyBwb3J0
J3MgZmlsZXMgbW92ZSBsYXRlciBpbiBhbg0KKwkgIHVwZ3JhZGUuICBUaGUg
cmlnaHQgd2F5IHRvIGRlY2xhcmUgUGVybCBtb2R1bGUgZGVwZW5kZW5jaWVz
DQorCSAgaXMgc2hvd24gaW4gdGhlIGV4YW1wbGUgYmVsb3cuPC9wYXJhPg0K
ICAgICAgIDwvbm90ZT4NCiANCiAgICAgICA8ZXhhbXBsZSBpZD0idXNlLXBl
cmwtZGVwZW5kZW5jeS1leGFtcGxlIj4NCi0JPHRpdGxlPlBFUkwgRGVwZW5k
ZW5jeSBFeGFtcGxlPC90aXRsZT4NCisJPHRpdGxlPlBlcmwgRGVwZW5kZW5j
eSBFeGFtcGxlPC90aXRsZT4NCiANCiAJPHByb2dyYW1saXN0aW5nPnA1LUlP
LVRlZSZndDs9MC42NDoke1BPUlRTRElSfS9kZXZlbC9wNS1JTy1UZWU8L3By
b2dyYW1saXN0aW5nPg0KICAgICAgIDwvZXhhbXBsZT4NCg==
---902635197-1945249235-1337804717=:49763--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.BSF.2.00.1205231414180.49763>