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

Re: Pre-RFC: markdown in pod

Thread Previous | Thread Next
From:
Tom Molesworth via perl5-porters
Date:
November 13, 2021 00:38
Subject:
Re: Pre-RFC: markdown in pod
Message ID:
CAGXhHdnYjLpHNdVPDiakY6VMOXNjZ0SQb4juxP7giGVtOS7c8g@mail.gmail.com
On Sat, 13 Nov 2021 at 00:20, Oodler 577 via perl5-porters <
perl5-porters@perl.org> wrote:

> * Neil Bowers <neilb@neilb.org> [2021-11-12 13:54:02 +0000]:
> It should be no surprise that I literally never think about what people
> not familiar with Perl think and I don't care about them unless they want
> to make an effort to *learn* Perl/perl. I recommend we all eschew the
> temptation
> to do so. We do so at our own per[i]l. I imply this a lot, but here it is
> stated
> very clearly.
>

That's... remarkably insular. Other ecosystems are great sources of
creative inspiration, with a much broader range of ideas we could be
applying. Not too clear what temptation exactly you're saying to eschew
here - caring about what people think? learning perl??

I'm surprised and disappointed to see a comment like this on a language's
core development discussion thread, and I really hope it's not a widespread
view.

Not a terrible thought, but what happens when we want,
>
> =format SQL
>
> =format asciidoc
>

Again, we already have this feature, and it's actively used - for example,
HTML sections are how people add images to documentation:

https://metacpan.org/dist/Tickit-Widget-Layout-Relative/source/lib/Tickit/Widget/Layout/Relative.pm#L52

and has been used for a range of purposes, e.g. embedding other language
examples or as a richer form of the __DATA__ section.

See perldoc perlpod:

        A command "=begin *formatname*", some paragraphs, and a command
        "=end *formatname*", mean that the text/data in between is meant for
        formatters that understand the special format called *formatname*.
        ...
        The command "=for *formatname* *text...*" specifies that the
        remainder of just this paragraph (starting right after *formatname*)
        is in that special format.

Markdown also includes something similar, it's just much more concise (as
always):

```sql
select * from some_table
```

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