note
jeffa
<p>
I have been quiet on this matter, but i have to pipe in and say that replacing [ .. ] with
[[ .. ]] is a SPLENDID idea and you hit the nail on the head <em>why</em> it is a
better fit for this site. (typing &#91; is a royal PITA!)
</p>
<p>
There seems to be two major problems (barring having all pages be W3C compliant (X)HTML)
<ol>
<li>newcomers not knowing how to format code sections</li>
<li>folks using "unescaped" [ .. ] sequences, inadvertently producing potential Google
hits to their array indices.</li>
</ol>
I think that getting newcomers to use code tags will always be a problem ... but switching
[ .. ] to [[ .. ]] should completely alleviate the need for "inline" code tags,
such as <code>$this->[$example]</code>.
</p>
<p>
As for using POD ... newbies have a hard enough with <em>programming</em>, let alone Perl.
Offer them POD and watch them run screaming ... maybe not a bad idea after all ...
</p>
<p>
My stock answer for posting with POD is <tt>pod2html | perl -pe 'custom filters here' | tidy</tt> which has served me quite well for several of my larger, premeditated posts.
</p>
<div class="pmsig"><div class="pmsig-18800">
<p>jeffa</p>
<font size=1>
<pre>
L-LL-L--L-LL-L--L-LL-L--
-R--R-RR-R--R-RR-R--R-RR
B--B--B--B--B--B--B--B--
H---H---H---H---H---H---
(<a href="http://jeffa.perlmonk.org/tripdid.mp3">the triplet paradiddle with high-hat</a>)
</pre></font>
</div></div>
328127
328276