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

Re: Pre-RFC: markdown in pod

Thread Previous | Thread Next
Tom Molesworth via perl5-porters
November 13, 2021 00:38
Re: Pre-RFC: markdown in pod
Message ID:
On Sat, 13 Nov 2021 at 00:20, Oodler 577 via perl5-porters <> wrote:

> * Neil Bowers <> [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

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:

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

select * from some_table

Thread Previous | Thread Next Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About