<div dir="ltr"><div class="gmail_quote">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 class="im"><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 class="HOEnZb"><font color="#888888"><div>
<br></div></font></span></div></blockquote><div><br></div><div>The notation is arbitrary anyway. Neither Perl nor Java use slashes or hash symbols, do they?</div><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 class="HOEnZb"><font color="#888888"><div></div><div>Shmuel. </div></font></span></div>
<br>_______________________________________________<br>
Perl mailing list<br>
<a href="mailto:Perl@perl.org.il">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></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>