Beefy Boxes and Bandwidth Generously Provided by pair Networks
laziness, impatience, and hubris
 
PerlMonks  

comment on

( [id://3333]=superdoc: print w/replies, xml ) Need Help??

Or give them the ten minute tutorial (with examples) that it usually takes to explain references adequately on IRC.

We do that only if they don't understand the documentation. And no, it does not take ten minutes. It would take ten minutes to teach it to intelligent people; but they don't need explanation because they understand the documentation. In practice, when someone doesn't understand the documentation, it takes up to one or two hours before they understand how references work.

What's the point of "helping" people if all you do is cite perldoc perl all the time.

Perldocs are a maze to most people. It is hard to find out that you need too look for "references" to get what you think is called "a two-dimensional array". It's hard to look up the flip-flop operator if you don't know that it is called an operator. Finding information about tr is hard if you think the answer can be in perlre. It's hard to read FAQs if you don't know they exist.

You know where and how to find documentation. I managed on my own too. But many people need a push in the right direction. Often, they don't mind reading documentation but they simply don't know which documents are good for them.

So this is how we help people on #perlhelp. We tell them to RTFM, and specify which manual. Depending on the situation, this can be a perldoc, Coping with Scoping, Suffering from Buffering, Beginning Perl, a module's POD, one of the many PM Tutorials, etcetera, etcetera.

Our strategy works. We don't just try to help, we actually help these people. And once in a while (3..5 times per day) someone needs more help than RTFM. Because we tell the others to RTFM, we have enough time to help the people who really need it.

The point of helping people if all we do is cite "perldoc $document" all the time is helping people.

In any case, it is far better for us to have to unlearn perldoc perlreftut than for Debian to violate the overly restrictive copyright on a single document in the Perl distribution. Better to remove the offending document than to remove perl itself. Afterall, perlreftut is useless when it comes to running scripts.

I agree that it is better to remove perlreftut than perl. I also agree that Debian did what it thought it had to do. I don't like what they had to do, though. It still is Debian's fault, though. Even though they cannot ship perlreftut, that's still because of *their* decisions.

I think the best solution would be to re-license perlreftut if that is possible. I think that'll happen eventually. In the meantime, people will be disappointed when they notice that this document is not installed on their computers.

Juerd # { site => 'juerd.nl', plp_site => 'plp.juerd.nl', do_not_use => 'spamtrap' }


In reply to RTFM works perlfectly. (Re: Re: Re: Re: Debian removed perlreftut) by Juerd
in thread Debian removed perlreftut by Juerd

Title:
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?
    Username:
    Password:

    What's my password?
    Create A New User
    Domain Nodelet?
    Chatterbox?
    and the web crawler heard nothing...

    How do I use this?Last hourOther CB clients
    Other Users?
    Others surveying the Monastery: (3)
    As of 2024-07-25 16:04 GMT
    Sections?
    Information?
    Find Nodes?
    Leftovers?
      Voting Booth?

      No recent polls found

      Notices?
      erzuuli‥ 🛈The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.