Re: Tables in PODs
On 09/20/2013 08:43 AM, Nicholas Clark wrote: 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) I do know roff. Looking briefly at the spec, it looks reasonably easy to do. Or how good plain text output for tables is. Nicholas Clark
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
Re: Tables in PODs
On Fri, 20 Sep 2013 15:43:00 +0100 Nicholas Clark n...@ccl4.org 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
