develooper Front page | perl.perl5.porters | Postings from November 2021

Re: Pre-RFC: tables in Pod

Thread Previous | Thread Next
From:
Tomasz Konojacki
Date:
November 16, 2021 02:58
Subject:
Re: Pre-RFC: tables in Pod
Message ID:
20211116035831.2D6C.5C4F47F8@xenu.pl
On Tue, 16 Nov 2021 10:51:53 +0800
Tom Molesworth via perl5-porters <perl5-porters@perl.org> wrote:

> The following is an observation, rather than a negative vote:
> 
> This proposal is inconsistent with the paragraph nature of POD - we end up
> with "rectangular POD", where paragraph formatting directives are embedded
> within visual sections of the markup rather than starting at the beginning
> of each line:
> 
> | B<Header 1>                   | B<Header 2>
>       |
> |-------------------------------|-------------------------------------------------|
> |=over 4                        |
>       |
> |                               |
>       |
> |=item * C<$x> - is a variable  |=for html <img src="
> https://perl.org/logo.bmp">  |
> |                               |
>       |
> |=back                          |
>       |
> 
> As such, I think it'll be a mess - for authors and toolchain
> implementations alike - and we'll end up  wishing we'd stuck with markdown.
> 
> A paragraph-based table definition would be tedious to write and hard to
> visualise, but would be more in the spirit of the existing POD definition.

I imagine using command paragraphs inside tables will be forbidden, only
formatting codes will be allowed. I think it's the sanest way out.

Thread Previous | Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About