Verbatim blocks only have to have one space from the left margin to be rendered as verbatim. I'm of the opinion that all other indentation should be four spaces and in K&R style. <br><br>If reading perldoc directly is a problem use Apache::Perldoc as an alternative interface.
<br><br><div><span class="gmail_quote">On 25/03/06, <b class="gmail_sendername">Matt S Trout</b> <<a href="mailto:dbix-class@trout.me.uk">dbix-class@trout.me.uk</a>> wrote:</span><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Andrew Ford wrote:<br>> I would still argue for 4 spaces. Personally I find two an indent of<br>> two spaces difficult to make out in some circumstances -- don't know<br>> whether it is just my age or eyesight. The Manual/Example.pod has
<br>> extended code samples with just a one character indent, which is<br>> impossible to discern under Emacs or printed out. The CPAN-style HTML<br>> formatting does of course make verbatim blocks very evident, but I for
<br>> one tend to view man pages in an Xterm, under Emacs or printed through<br>> groff and badly formatted man pages are a right pain.<br><br>Example.pod is all two now, which seems to be the "usual" standard in POD and
<br>is definitely how the entirety of DBIx::Class is written. I don't think it's<br>overly illegible and has the advantage of avoiding linebreaks even under<br>perldoc on an 80x25 xterm (which is what I read everything in :)
<br><br>--<br> Matt S Trout Offering custom development, consultancy and support<br> Technical Director contracts for Catalyst, DBIx::Class and BAST. Contact<br>Shadowcat Systems Ltd. mst (at) <a href="http://shadowcatsystems.co.uk">
shadowcatsystems.co.uk</a> for more information<br><br>+ Help us build a better perl ORM: <a href="http://dbix-class.shadowcatsystems.co.uk/">http://dbix-class.shadowcatsystems.co.uk/</a> +<br><br>_______________________________________________
<br>List: <a href="http://lists.rawmode.org/cgi-bin/mailman/listinfo/dbix-class">http://lists.rawmode.org/cgi-bin/mailman/listinfo/dbix-class</a><br>Wiki: <a href="http://dbix-class.shadowcatsystems.co.uk/">http://dbix-class.shadowcatsystems.co.uk/
</a><br>IRC: irc.perl.org#dbix-class<br>SVN: <a href="http://dev.catalyst.perl.org/repos/bast/trunk/DBIx-Class/">http://dev.catalyst.perl.org/repos/bast/trunk/DBIx-Class/</a><br></blockquote></div><br>