http://www.perlmonks.org?node_id=598539


in reply to Re: RFC:A brief tutorial on Perl's native sorting facilities.
in thread RFC:A brief tutorial on Perl's native sorting facilities.

Thanks. Corrected above.

Now the $64,000 questions:


Examine what is said, not who speaks -- Silence betokens consent -- Love the truth but pardon error.
"Science is about questioning the status quo. Questioning authority".
In the absence of evidence, opinion is indistinguishable from prejudice.
  • Comment on Re^2: RFC:A brief tutorial on Perl's native sorting facilities.

Replies are listed 'Best First'.
Re^3: RFC:A brief tutorial on Perl's native sorting facilities.
by blazar (Canon) on Feb 06, 2007 at 17:19 UTC
    Thanks. Corrected above.

    But now you have:

    "By using the built-in perlopcmp operator [...]"

    ITYM something like "By using the built-in cmp operator [...]"

      How stable is that link? I fell into the trap of using references to the Perl docs on perldoc.org for a while as they were more up to date than those on PM, but it was a mistake. Initially, the site was fine, but after a short while it became flacky, spending more time down than up. And then it simply disappeared.

      Of course, if it was possible to produce properly indexed HTML using pod, we be able to link directly to the section of perlop entitled "Equality operators", which would be a significant improvement. But that ain't gonna happen anytime soon.


      Examine what is said, not who speaks -- Silence betokens consent -- Love the truth but pardon error.
      "Science is about questioning the status quo. Questioning authority".
      In the absence of evidence, opinion is indistinguishable from prejudice.
        How stable is that link?

        It doesn't matter, if you use the preferred [doc://perlop|cmp] shortcut. Currently, that shortcut type is hardcoded to go to perldoc.perl.org, but if that site ever goes away or gets restructured, pmdev can rework the doc:// shortcut to unbreak all the links that use it.

        A word spoken in Mind will reach its own level, in the objective world, by its own weight
        How stable is that link? I fell into the trap of using references to the Perl docs on perldoc.org for a while as they were more up to date than those on PM, but it was a mistake. Initially, the site was fine, but after a short while it became flacky, spending more time down than up. And then it simply disappeared.

        It was not really about perldoc vs PM as much as about the appearence of "perldoccmp", to which I guessed you would prefer something more informative, like "cmp (described in perlop)" or "cmp (described in perldoc perlop)". Then direct the link to the resource you like most. I suggested a more compact form, but that was just a possibility.

        Of course I always stick to perldoc because I've seen it advised in several places the recommendation to favour it. Yes: you're right that it is a little bit unstable. But it doesn't seem to me that it has disappeared. Indeed it's working for me now.

        Of course, if it was possible to produce properly indexed HTML using pod, we be able to link directly to the section of perlop entitled "Equality operators", which would be a significant improvement. But that ain't gonna happen anytime soon.

        Well, within perldoc.perl.org you can directly link to sections like that: Equality Operators.