<div dir="ltr"><div class="gmail_quote">On Thu, Aug 16, 2012 at 9:47 AM, Gaal Yahas <span dir="ltr">&lt;<a href="mailto:gaal@forum2.org" target="_blank">gaal@forum2.org</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div dir="ltr"><div class="gmail_quote"><div><div class="h5">On Thu, Aug 16, 2012 at 9:46 AM, Shmuel Fomberg <span dir="ltr">&lt;<a href="mailto:shmuelfomberg@gmail.com" target="_blank">shmuelfomberg@gmail.com</a>&gt;</span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div class="gmail_quote"><div><div>Gaal said: </div><div><br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">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.<div>


<br></div><div>
Alternatively, if you&#39;re persuaded you need something better, shop around for existing alternatives. Javadoc style (<a href="http://package.name#method" target="_blank">package.name#method</a>) comes to mind, and there&#39;s a chance people coming across your docs will already be familiar with that.<br>


</div></div></blockquote><div><br></div></div><div>well, I can&#39;t use that, as the Perl modules do not use dots, but package::name#method is similar enough, I think.</div><span><font color="#888888"><div>
<br></div></font></span></div></blockquote><div><br></div></div></div><div>The notation is arbitrary anyway. Neither Perl nor Java use slashes or hash symbols, do they?</div><div></div></div></div></blockquote><div><br></div>
<div>(Also consider how some CPAN tools name dists, e.g. Acme-Bleach. That dash is not part of an identifier in Perl the language.)</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div dir="ltr"><div class="gmail_quote"><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div class="gmail_quote"><span><font color="#888888"><div></div><div>Shmuel. </div></font></span></div><div class="im">
<br>_______________________________________________<br>
Perl mailing list<br>
<a href="mailto:Perl@perl.org.il" target="_blank">Perl@perl.org.il</a><br>
<a href="http://mail.perl.org.il/mailman/listinfo/perl" target="_blank">http://mail.perl.org.il/mailman/listinfo/perl</a><br></div></blockquote></div><div class="im"><br><br clear="all"><div><br></div>-- <br>Gaal Yahas &lt;<a href="mailto:gaal@forum2.org" target="_blank">gaal@forum2.org</a>&gt;<br>

<a href="http://gaal.livejournal.com/" target="_blank">http://gaal.livejournal.com/</a><br>
</div></div>
</blockquote></div><br><br clear="all"><div><br></div>-- <br>Gaal Yahas &lt;<a href="mailto:gaal@forum2.org">gaal@forum2.org</a>&gt;<br><a href="http://gaal.livejournal.com/">http://gaal.livejournal.com/</a><br>
</div>