Beefy Boxes and Bandwidth Generously Provided by pair Networks
XP is just a number

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

Replies are listed 'Best First'.
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?

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://389923]
[LanX]: Oh, you spread measles in your saliva?
[LanX]: ... and why did you bite hos daughter?
[LanX]: *his
[holli]: And this guy was also Anti-Vaxx and I just snapped. I shoed him all over the yard
[james28909]: biting between the legs? now thats my kind of religion.
[holli]: and back into the building, saw him later peeking out of the window looking scared. It was hilarious.
[LanX]: Let's get physical...
[james28909]: wish i could stay and chat. i have an unsuspecting client to give an estimate to. muhhahaha

How do I use this? | Other CB clients
Other Users?
Others perusing the Monastery: (16)
As of 2017-12-13 18:10 GMT
Find Nodes?
    Voting Booth?
    What programming language do you hate the most?

    Results (373 votes). Check out past polls.