Re: allowing L<text|href>

On Dec 1, 2009, at 1:48 PM, Russ Allbery wrote:

> I think this output is correct for everything except the last form.
> There's a long tradition of the text before the vertical bar being what
> should be displayed in a text document for Pod::Text and Pod::Man for
> those places where it was already supported, and I don't think we want to
> break that.  Existing documents expect that behavior.

Okay. I'm fine to leave it and implement a Markdown formatter instead.

> For the latter, I think the best rendering for both Pod::Text and Pod::Man
> is:
> 
>    perl.org <http://perl.org>
> 
> and that's what I plan to implement.  That's a fairly natural expression
> of a URL in a text document and follows the IETF recommendation.

Fair enough. I can change Pod::Simple::Text to do the same.

> This isn't a very natural written English way of expressing a link.  I
> think producing Markdown output is a great idea, but Markdown is another
> formatting language.  It's not plain text and shouldn't be the output of a
> translator to text.

Agreed.

Best,

David