Beefy Boxes and Bandwidth Generously Provided by pair Networks
XP is just a number
 
PerlMonks  

Re: Shortcut for referencing specific sections of CPAN documents

by Anonymous Monk
on Aug 12, 2012 at 09:07 UTC ( #986946=note: print w/ replies, xml ) Need Help??


in reply to Shortcut for referencing specific sections of CPAN documents

Hi

mod is broken , anchors don't work at all, and the module name gets query escaped

doc is broken, anchors don't work right (haven't for very long time), and at one point perldoc.perl.org has updated the way anchor names are generated (dashes instead of underscores or space, but my memory is fuzzy), breaking lots of existing anchor links

Example  [doc://perlintro#String comparison], [doc://perlintro#String-comparison] -> String comparison, String comparison

I prefer href://, esp http://search.cpan.org/perldoc/Text::CSV#print because the module name doesn't get escaped (the :: still look like ::)

http://metacpan.org/module/Text::CSV#print is also good, but I stick with /perldoc/ because of (tools and dist) http://search.cpan.org/tools/CGI and http://search.cpan.org/dist/illguts/index.html

Speaking of bugs and broken links

I don't seen why the old perlop headings/anchors like s/PATTERN/REPLACEMENT/egimosx got dropped -- even s/PATTERN/REPLACEMENT/ and especially s/// ought to work, you never know what a new version of perl will bring, the old links ought to work

So fixing mod://, its a good idea, I prefer /perldoc/

Fixing doc:// would break some existing links, might require a heavyhanded solution (live test links, find nearest matching anchor, cache the results )


Comment on Re: Shortcut for referencing specific sections of CPAN documents
Download Code

Log In?
Username:
Password:

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

How do I use this? | Other CB clients
Other Users?
Others musing on the Monastery: (9)
As of 2014-12-28 17:00 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

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





    Results (182 votes), past polls