<div class="gmail_quote"><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>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><div><br></div><div>Shmuel. </div></div>