develooper Front page | perl.pod-people | Postings from October 2020

Re: [feature] Add =image to perl pod #18169

Thread Previous | Thread Next
From:
Dmitry Karasik
Date:
October 1, 2020 20:53
Subject:
Re: [feature] Add =image to perl pod #18169
Message ID:
20201001205300.GA76716@nataraj.eu.org
> 
> I think you may be assuming there would be some special handling of P<> in
> a paragraph by itself as distinct from P<> in a paragraph with surrounding
> text, but if so I think that would be the first place in POD where a
> formatting code is handled differently based on its surrounding context.

Yes, that's correct. 

> I'm not sure that's a good precedent to set.

Do think that DWIM magic is too strong here?

> complexity that makes implementation a bit harder.  Plus, the author may
> have intended to have a paragraph consisting only of an emoji and would be
> quite surprised if that emoji turned into a figure!

That can be fixed by adding a Z<>, but you have a point.

> My preference is therefore for some method of markup that would make it
> explicit whether the image is intended to be inline or set off in a
> figure, because these are going to require different handling in a lot of
> output formats.

Nothing wrong with that, but that makes the syntax overburdened and less elegant.
If comes to this, I would rather skip that different handling altogether, sacrificing
either figure or inline image, for the sake of keeping P<> syntax straighforward.

> (Also, and I realize this was only an example, but I would not use images
> to show mathematical formulas.  For HTML output, MathJax would produce
> much better results.  That's a different topic of discussion, though, and
> I'm not volunteering to implement eqn support in Pod::Man....)

I had only formulas examples in mind, so if that's the case, I'm willing to give up the inline support.

-- 
Sincerely,
	Dmitry Karasik

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