Beefy Boxes and Bandwidth Generously Provided by pair Networks
Your skill will accomplish
what the force of many cannot
 
PerlMonks  

Re: POD: advice sought over correct usage

by jryan (Vicar)
on Sep 09, 2004 at 23:35 UTC ( #389923=note: print w/ replies, xml ) Need Help??


in reply to POD: advice sought over correct usage

Which POD parser/formatter are you using? Have you tried Pod::Simple?


Comment on Re: POD: advice sought over correct usage
Re^2: POD: advice sought over correct usage
by calin (Deacon) on Sep 10, 2004 at 16:36 UTC

    Thanks for the Pod::Simple tip.

    I'm currently trying out Pod::Simpe::HTML, and it looks more spiffy than pod2html. It does blockquote right when it encounters =over ... =back spans without enclosed =items.

    pod2html currently does line-by-line processing (no deferred output), so it can't go back and add a starting <blockquote> tag when it arrives at the =back without seeing any =item in between. (without modification of program logic and data flow, of course, so there's not a matter of a simple patch).

    FYI, here's what perlpodspec is saying (though it doesn't read as a requirement to put blockquotes in HTML formatting):

    An "=over" ... "=back" region containing no "=item" paragraphs at all, and containing only some number of ordinary/verbatim paragraphs, and possibly also some nested "=over" ... "=back" regions, "=for..." paragraphs, and "=begin"..."=end" regions. Such an itemless "=over" ... "=back" region in Pod is equivalent in meaning to a "<blockquote>...</blockquote>" element in HTML.

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://389923]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others imbibing at the Monastery: (5)
As of 2015-07-03 03:56 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    The top three priorities of my open tasks are (in descending order of likelihood to be worked on) ...









    Results (48 votes), past polls