[Israel.pm] Modules and functions notation
gaal at forum2.org
Wed Aug 15 23:49:05 PDT 2012
On Thu, Aug 16, 2012 at 9:47 AM, Gaal Yahas <gaal at forum2.org> wrote:
> On Thu, Aug 16, 2012 at 9:46 AM, Shmuel Fomberg <shmuelfomberg at gmail.com>wrote:
>> Gaal said:
>> The clarity gained by a more readable standard is often eclipsed by the
>>> confusion for people encountering it for the first time. Unless your
>>> audience is small, this might not be worth it.
>>> Alternatively, if you're persuaded you need something better, shop
>>> around for existing alternatives. Javadoc style (package.name#method)
>>> comes to mind, and there's a chance people coming across your docs will
>>> already be familiar with that.
>> well, I can't use that, as the Perl modules do not use dots, but
>> package::name#method is similar enough, I think.
> The notation is arbitrary anyway. Neither Perl nor Java use slashes or
> hash symbols, do they?
(Also consider how some CPAN tools name dists, e.g. Acme-Bleach. That dash
is not part of an identifier in Perl the language.)
>> Perl mailing list
>> Perl at perl.org.il
> Gaal Yahas <gaal at forum2.org>
Gaal Yahas <gaal at forum2.org>
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the Perl