[Israel.pm] Modules and functions notation

Gaal Yahas 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.)


>
>
>> Shmuel.
>>
>> _______________________________________________
>> Perl mailing list
>> Perl at perl.org.il
>> http://mail.perl.org.il/mailman/listinfo/perl
>>
>
>
>
> --
> Gaal Yahas <gaal at forum2.org>
> http://gaal.livejournal.com/
>



-- 
Gaal Yahas <gaal at forum2.org>
http://gaal.livejournal.com/
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.perl.org.il/pipermail/perl/attachments/20120816/a8fd93ae/attachment.htm 


More information about the Perl mailing list