Tables in PODs
Is there any specification for tables in PODs? I haven't been able to find any. Isn't it about time tables were added? I have attached a specification for them for your review. -- Don't stop where the ink does. Shawn tables.pod Description: Binary data
Contiguous Specification
I might as well throw this one out there too. This is only for parsers that create multiple pages. Those which don't can skip it. And, of course, older parsers will ignore it. =begin :contiguous =end :contiguous Items within a contiguous section will be render on the same page, if possible. If not, they will be render on a few pages as possible. Single, regular paragraphs can be contiguous with: =for :contiguous paragraph Note that older parsers will ignore these paragraphs too. To ensure that they are render by older parsers, use the `=begin/=end` specification instead. -- Don't stop where the ink does. Shawn
Re: Tables in PODs
On Fri, 20 Sep 2013 15:43:00 +0100 Nicholas Clark wrote: > There is a perl 6 specification for tables. See > > https://raw.github.com/perl6/specs/master/S26-documentation.pod Interesting. But some problems with it. 1. It breaks old parsers. 2. Does not allow for full POD specifications in cells. That is, you cannot put a verbatim paragraph or a `=over/=item/=back` list in a cell. (You also can't nest tables but we may not want to go there.) -- Don't stop where the ink does. Shawn
Re: Tables in PODs
On Fri, Sep 20, 2013 at 10:30:13AM -0400, Shawn H Corey wrote: > Is there any specification for tables in PODs? I haven't been able to > find any. Isn't it about time tables were added? I have attached a > specification for them for your review. There is a perl 6 specification for tables. See https://raw.github.com/perl6/specs/master/S26-documentation.pod and an implementation for Perl 5, at least for HTML: https://metacpan.org/module/Perl6::Pod However, the big question I don't know the answer to is if anyone has implemented code to output tables to man pages. man can do tables (very nicely), but I know approximately zero roff, so I don't know how easy it is (or isn't) Or how good plain text output for tables is. Nicholas Clark