Re: allowing L<text|href>

On Dec 1, 2009, at 12:18 PM, Ricardo Signes wrote:

>> Yeah, and it looks like it pretty well matches what RJBS and I sketched out.
>> Ricardo, are you looking to update perlpod and perlpodspec for 5.12, then? As
>> soon as that's in, I'll send a patch for Test::Pod (turns out the change is
>> quite simple).
> 
> I will update the documents, although I'm not sure if Jesse will want to get 
> those changes in 5.12.  I'll talk to him.  If he's game, I'll do it.

Cool.

I just wrote tests for the text output from Pod::Simple::Text. It's like this:

            POD                     | Text Output
    --------------------------------+------------------
    L<things|crontab(5)>            | things
    L<things|crontab(5)/foo>        | things
    L<Perl Error Messages|perldiag> | Perl Error Message
    L<perl.org|http://perl.org>     | perl.org

I think it most unfortunate that the URL is lost in text output. I see two ways around this:

1. Change it to output with the URL using something like Markdown format:

            POD                     | Text Output
    --------------------------------+--------------------------------
    L<things|crontab(5)>            | [things](crontab(5))
    L<things|crontab(5)/foo>        | [things](crontab(5)/foo)
    L<Perl Error Messages|perldiag> | [Perl Error Message](perldiag)
    L<perl.org|http://perl.org>     | [perl.org](http://perl.org)

2. Or, if people hate that, perhaps implement Pod::Simple::Markdown to emit Markdown and leave Pod::Simple::Text as-is.

Thoughts?

Not sure what Pod::Man does…

Best,

David