From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1O0Oq0-0000aM-9c for garchives@archives.gentoo.org; Sat, 10 Apr 2010 00:46:19 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 9F817E077E; Sat, 10 Apr 2010 00:46:09 +0000 (UTC) Received: from eagle.jhcloos.com (eagle.jhcloos.com [207.210.242.212]) by pigeon.gentoo.org (Postfix) with ESMTP id 54CCBE0776 for ; Sat, 10 Apr 2010 00:46:08 +0000 (UTC) Received: by eagle.jhcloos.com (Postfix, from userid 10) id 20704401E0; Sat, 10 Apr 2010 00:45:44 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=jhcloos.com; s=eagle; t=1270860368; bh=KgUa4rMX/rJHY3s2EI0d9neaCXNz+Z4W1laiOkutGRI=; h=From:To:Subject:In-Reply-To:References:Date:Message-ID: MIME-Version:Content-Type; b=GHt1ls7r5aNBfLrvzXXLaAfMRRD6+X+tfA+Ufu8bP4ast+cHb0FzBwAfVhIAFMBKe USkxkTMQAjWniv0DS94NNd+Da9TTThePESA7x7BVC1faIct+/bIHZncmRdq/vDxdaj vUrN661+/9G2OKjGuDer7ZEkQxaPzRxMhPOqLXKI= Received: from lugabout.jhcloos.org (localhost [127.0.0.1]) by lugabout.jhcloos.org (Postfix) with ESMTP id 1A57EA010A for ; Sat, 10 Apr 2010 00:40:44 +0000 (UTC) From: James Cloos To: gentoo-dev@lists.gentoo.org Subject: Re: [gentoo-dev] Re: perl eclass review - EAPI=3 + new helper eclass In-Reply-To: (Duncan's message of "Tue, 6 Apr 2010 14:52:10 +0000 (UTC)") References: <20100330111154.GA28735@veller.net> <20100403122902.TAc3125.tv@veller.net> <20100404012509.24141bbc@lappy.evolone.org> User-Agent: Gnus/5.110011 (No Gnus v0.11) Emacs/24.0.50 (gnu/linux) Face: iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAABHNCSVQICAgIfAhkiAAAAI1J REFUOE+lU9ESgCAIg64P1y+ngUdxhl5H8wFbbM0OmUiEhKkCYaZThXCo6KE5sCbA1DDX3genvO4d eBQgEMaM5qy6uWk4SfBYfdu9jvBN9nSVDOKRtwb+I3epboOsOX5pZbJNsBJFvmQQ05YMfieIBnYX FK2N6dOawd97r/e8RjkTLzmMsiVgrAoEugtviCM3v2WzjgAAAABJRU5ErkJggg== Copyright: Copyright 2009 James Cloos OpenPGP: ED7DAEA6; url=http://jhcloos.com/public_key/0xED7DAEA6.asc OpenPGP-Fingerprint: E9E9 F828 61A4 6EA9 0F2B 63E7 997A 9F17 ED7D AEA6 Date: Fri, 09 Apr 2010 20:40:19 -0400 Message-ID: Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Hashcash: 1:30:100410:gentoo-dev@lists.gentoo.org::FFMShUg8OgXtrM03:000000000000000000000000000000000/GMFQ X-Archives-Salt: 377e0738-78e9-4e5a-ad59-8bae69d5b2e7 X-Archives-Hash: 61b4d362f5a548b3513efda68ec1af11 >>>>> "D" == Duncan <1i5t5.duncan@cox.net> writes: D> While you're correct in the ordinary case, keep in mind that this is perl D> developer docs we're talking about here -- not ordinary user documentation. Developer docs *are* ordinary user documentation. Section 3 is perhaps the most used section of man, with sections 2 and, depending on platform, one or more of sections 4, 5 or 6 following. D> And those that know enough about perl to find the developer documentation D> useful should also know how to use perldoc, You are ignoring the fact that having the docs in man is more useful; much easier to use, usable by any man reader. The list goes on. There is simply no *real* benefit to eliding them, it only does harm. People who do not want to install them should specify that preference via a USE flag (-man, perhaps). It would even be OK were the USE flag off by default; but making it impossible to Do The Right Thing w/o editing eclasses every time one syncs is just wrong. -JimC -- James Cloos OpenPGP: 1024D/ED7DAEA6