http://qs321.pair.com?node_id=11101410


in reply to Bookmarklet to show deeplinks in perldoc.perl.org

Have you tried expoiting perldoc.pl instead?

map{substr$_->[0],$_->[1]||0,1}[\*||{},3],[[]],[ref qr-1,-,-1],[{}],[sub{}^*ARGV,3]

Replies are listed 'Best First'.
Re^2: Bookmarklet to show deeplinks in perldoc.perl.org
by LanX (Saint) on Jun 15, 2019 at 17:42 UTC
    not sure what your point is, PM doesn't have a doc-markup for perldoc.pl yet

    you are free to adapt the BML to the format in perldoc.pl to show all hidden deeplinks.

    update

    OK I see that perldoc.pl is showing a # symbol left to every deeplink on mouse-over. Clicking on the # will jump to the deeplink and one can copy it from the url-bar

    example: https://perldoc.pl/perlfunc.html#open-FILEHANDLE,MODE,EXPR,LIST

    Nice!

    Cheers Rolf
    (addicted to the Perl Programming Language :)
    Wikisyntax for the Monastery FootballPerl is like chess, only without the dice

Re^2: Bookmarklet to show deeplinks in perldoc.perl.org
by jdporter (Paladin) on Jun 17, 2019 at 14:08 UTC

    A year ago, we had some discussion about switching to perldoc.pl. It was left unresolved. I want to know what the arguments are on both sides. It was claimed that perldoc.perl.org was moribund, yet I don't see any evidence that that's true. If I can be convinced that perldoc.pl is a better choice for our (PM) needs, I'll switch it.

    I reckon we are the only monastery ever to have a dungeon stuffed with 16,000 zombies.
      See for example Reddit or GitHub for some discussions. It's probably too early to judge the new beta version of perldoc.org. perldoc.pl has been, on the other hand, mature for some time already.

      map{substr$_->[0],$_->[1]||0,1}[\*||{},3],[[]],[ref qr-1,-,-1],[{}],[sub{}^*ARGV,3]
      > If I can be convinced that perldoc.pl is a better choice for our (PM) needs, I'll switch it.

      some thoughts:

      • If switching means that old doc-links will refer to perldoc.pl I'm not sure if URL paths are consistent.
      • We used to have a [metacpan:://...] alternative to [cpan://..] . ( [docpl://..] might be an option but I'm not too convinced.)
      • you may add a user setting such that users like Choroba can choose jumping perldoc.pl for each ... link

      Personally I prefer direct auto-linking of bare http-URLs. My wikisyntax does this.

      > It was claimed that perldoc.perl.org was moribund,

      I only had minor issues with perldoc.perl.org. (like the need to scroll up after a deeplink, because the first lines where covered by the navbar.)

      And like already mentioned in the OP are possible deep-targets not easily accessible.

      What I have trouble to understand is why they suddenly replaced it with a worse beta-version of something else.

      Cheers Rolf
      (addicted to the Perl Programming Language :)
      Wikisyntax for the Monastery FootballPerl is like chess, only without the dice

        If switching means that old doc-links will refer to perldoc.pl I'm not sure if URL paths are consistent.

        OTOH, not switching would have the same problem, as perldoc.perl.org is messing with their own stuff.

        But I'm not sure this is in fact a problem. [doc://open] has no URL paths.

        direct auto-linking of bare http-URLs.

        I have no idea what that means. Can you clarify? TIA.

        I reckon we are the only monastery ever to have a dungeon stuffed with 16,000 zombies.
        > why they suddenly replaced it

        Because the old one was out of date (it hadn't been updated for more than a year, so it didn't show the latest Perl version's documentation, it was stuck at 5.26 IIRC) and there was no one to maintain it in its current state.

        Another question is, why they suddenly replaced it when a replacement had already existed at perldoc.pl. I don't know the answer.

        map{substr$_->[0],$_->[1]||0,1}[\*||{},3],[[]],[ref qr-1,-,-1],[{}],[sub{}^*ARGV,3]
        Any URL paths to actual documentation pages should still work. Index pages are an invention of perldoc.perl.org and won't, though I could be convinced to add forwarding for them. -Grinnz
        There's no longer an obvious search function? I have to go digging through, and think about whether my issue is a function, syntax, or special variable? I prefer the other.

        -QM
        --
        Quantum Mechanics: The dreams stuff is made of

      At the time, the last evidence of maintenance was adding Perl 5.26 at the end of 2017, and there was no evidence of anyone fixing bugs since 2011 (several of which have yet to be fixed so far, and many new ones now added, but we'll see what the next iteration brings). The revamp work was entirely unknown aside from vague promises of "an update" until last week; so until then I would have agreed with "moribund", and indeed that was the motivation for perldoc.pl, but that is clearly no longer apt.

        Yes; and before the recent revamp, there wasn't even any indication or link to whoever was responsible for maintaining the site. Upon that, yo invoco la vacacaca.

        I reckon we are the only monastery ever to have a dungeon stuffed with 16,000 zombies.