Beefy Boxes and Bandwidth Generously Provided by pair Networks
Just another Perl shrine

Comment on

( #3333=superdoc: print w/replies, xml ) Need Help??


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 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 because the module name doesn't get escaped (the :: still look like ::) is also good, but I stick with /perldoc/ because of (tools and dist) and

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 )

In reply to Re: Shortcut for referencing specific sections of CPAN documents by Anonymous Monk
in thread Shortcut for referencing specific sections of CPAN documents by Athanasius

Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post; it's "PerlMonks-approved HTML":

  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.
  • Log In?

    What's my password?
    Create A New User
    [hippo]: See also Getting Started with Perl for some gentle introductory tutorials.

    How do I use this? | Other CB clients
    Other Users?
    Others avoiding work at the Monastery: (7)
    As of 2018-02-21 09:54 GMT
    Find Nodes?
      Voting Booth?
      When it is dark outside I am happiest to see ...

      Results (276 votes). Check out past polls.