in reply to Re: POD: advice sought over correct usage
in thread POD: advice sought over correct usage
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.
|
|---|