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
