<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">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>
<br><div class="gmail_quote">
On Wed, Aug 15, 2012 at 10:57 AM, sawyer x <span dir="ltr">&lt;<a href="mailto:xsawyerx@gmail.com" target="_blank">xsawyerx@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 dir="ltr"><div class="gmail_quote"><div>On Wed, Aug 15, 2012 at 7:54 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">

<br><div>I find it easier on the eye to see what part is the module, and what is the function.</div><div>this oppose to the perl-code notation of Module::Name::function_name.</div></blockquote></div><div><br>I&#39;m quite comfortable with that because of the clear naming convention there.<br>



I think yours is equally (if not more) readable.<br></div></div></div>
<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></blockquote></div><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>