Re: Announcing the Perl 5 Documentation Team

On Fri, Jul 2, 2010 at 6:08 PM, Gabor Szabo <[email protected]> wrote:
> On Fri, Jul 2, 2010 at 5:55 PM, Caleb Cushing <[email protected]> wrote:
>> On Fri, Jul 2, 2010 at 10:33 AM, Gabor Szabo <[email protected]> wrote:
>>> Interestingly I would have said that the documentation is mostly needed
>>> by novices or by people who rarely use Perl. The difference might be
>>> because I encounter so many people who are learning Perl.
>>
>>
>> depends on /what/ documentation you're talking about. you're talking
>> language basics documentation... however documentation goes way beyond
>> the basics. You really mean to say that you go look at the code every
>> time you need to know how to use a sub that you haven't used before
>> (or perhaps recently)?
>>
>>
>> # grumble about having to remember to use reply to all
>
> No, I meant to say that the people I encounter do that.

let me be even more specific. They will look it up in Google.

Chas,  I am not sure:

$ perldoc -q trim
No documentation for perl FAQ keyword `trim' found

# perldoc -q open
gives a lot of FAQs but none of them gives the simple case
of

   open my $fh, '<', $filename or die $!;
   while (my $line = <$fh>) {
   }


Though this is 5.10.1 here so it might have changed since then or I might
have misunderstood your comment.

Gabor