On Thu, Aug 16, 2012 at 9:47 AM, Gaal Yahas <[email protected]> wrote:

> On Thu, Aug 16, 2012 at 9:46 AM, Shmuel Fomberg 
> <[email protected]>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
>> [email protected]
>> http://mail.perl.org.il/mailman/listinfo/perl
>>
>
>
>
> --
> Gaal Yahas <[email protected]>
> http://gaal.livejournal.com/
>



-- 
Gaal Yahas <[email protected]>
http://gaal.livejournal.com/
_______________________________________________
Perl mailing list
[email protected]
http://mail.perl.org.il/mailman/listinfo/perl

Reply via email to