Beefy Boxes and Bandwidth Generously Provided by pair Networks
Perl-Sensitive Sunglasses
 
PerlMonks  

Re^2: hyperlinks in pod

by jpl (Monk)
on Sep 27, 2011 at 21:02 UTC ( #928184=note: print w/ replies, xml ) Need Help??


in reply to Re: hyperlinks in pod
in thread hyperlinks in pod

The vestigial <'s and >'s are ugly and confusing. They make it appear that you omitted a pod formatting code

Aside from delimiting a url in text, how else would you distinguish the beginning and end of a url in text-only console?

How would you tell these apart without delimiters?

Visit L<http://example.com/hi?there>. Visit L<http://example.com/hi?there.> Visit L<http://example.com/hi?there:>+buddy Visit L<http://example.com/hi?there:+buddy>
Perhaps with something like B<...> or C<...> do in a text-only environment. Certainly not with something that was indistinguishable from a missing or invalid format code.
It hasn't gone unnoticed :) Though I don't immediately see it in

https://rt.perl.org/rt3/Public/Search/Simple.html?q=pod%3A%3Ahtml/https://rt.perl.org/rt3//Public/Search/Simple.html?q=pod2html

I've seen this bug reported before, and rejected as not-a-bug, as per http://perldoc.perl.org/perlpodspec.html#About-L%3C...%3E-Codes

I'm interested in the conflict between current documentation and current behavior. As far as I can tell, I'm following current documentation, which is in conflict with current behavior, as other responders have observed.


Comment on Re^2: hyperlinks in pod
Download Code
Re^3: hyperlinks in pod
by Anonymous Monk on Sep 28, 2011 at 09:00 UTC

    Perhaps with something like B<...> or C<...> do in a text-only environment.

    Hmm, both stars and quotes (*italic* and "code") seem more common than <> in urls ... and they're already used for emphasis

    Certainly not with something that was indistinguishable from a missing or invalid format code.

    But you see, stray angle brackets are perfectly valid in pod, but podchecker -w -w ... will warn you if you're interested

    *** WARNING: 2 unescaped <> in paragraph at line 18 in file ...

    And you will be warned about invalid formatting codes (even from pod2text), like

    Around line 16: Deleting unknown formatting code R<>

    I personally feel this is a mistake, its like a browser appending a list of html errors at the bottom of each page, after all, perldoc/pod2text/pod2html... aren't exactly author tools like podchecker/Pod::Checker, podtidy/Pod::Tidy, podlinkcheck/App::PodLinkCheck, podlint/Pod::POM, pod_cover/Pod::Coverage, Test::Pod, Test::Pod::Coverage, Test::XT

    As far as I can tell, I'm following current documentation, which is in conflict with current behavior, as other responders have observed.

    Yes, I concluded this also, same me Re^2: hyperlinks in pod :)

    Oh look pod2cpanhtml/App::Pod2CpanHtml

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://928184]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others studying the Monastery: (13)
As of 2014-12-26 17:29 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    Is guessing a good strategy for surviving in the IT business?





    Results (174 votes), past polls