[Dbix-class] Documentation formatting

Kieren Diment diment at gmail.com
Mon Mar 27 13:55:52 CEST 2006


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.

If reading perldoc directly is a problem use Apache::Perldoc as an
alternative interface.

On 25/03/06, Matt S Trout <dbix-class at trout.me.uk> wrote:
>
> Andrew Ford wrote:
> > I would still argue for 4 spaces.  Personally I find two an indent of
> > two spaces difficult to make out in some circumstances -- don't know
> > whether it is just my age or eyesight.  The Manual/Example.pod has
> > extended code samples with just a one character indent, which is
> > impossible to discern under Emacs or printed out.  The CPAN-style HTML
> > formatting does of course make verbatim blocks very evident, but I for
> > one tend to view man pages in an Xterm, under Emacs or printed through
> > groff and badly formatted man pages are a right pain.
>
> Example.pod is all two now, which seems to be the "usual" standard in POD
> and
> is definitely how the entirety of DBIx::Class is written. I don't think
> it's
> overly illegible and has the advantage of avoiding linebreaks even under
> perldoc on an 80x25 xterm (which is what I read everything in :)
>
> --
>       Matt S Trout       Offering custom development, consultancy and
> support
>    Technical Director    contracts for Catalyst, DBIx::Class and BAST.
> Contact
> Shadowcat Systems Ltd.  mst (at) shadowcatsystems.co.uk for more
> information
>
> + Help us build a better perl ORM:
> http://dbix-class.shadowcatsystems.co.uk/ +
>
> _______________________________________________
> List: http://lists.rawmode.org/cgi-bin/mailman/listinfo/dbix-class
> Wiki: http://dbix-class.shadowcatsystems.co.uk/
> IRC: irc.perl.org#dbix-class
> SVN: http://dev.catalyst.perl.org/repos/bast/trunk/DBIx-Class/
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.rawmode.org/pipermail/dbix-class/attachments/20060327/d328f4ce/attachment.htm 


More information about the Dbix-class mailing list