On Thu, Sep 10, 2009 at 13:12, Bryan R Harris
<bryan_r_har...@raytheon.com> wrote:
snip
> My point is that-that's not obvious.  Why would anyone perldoc perl?  Isn't
> perldoc already about perl?  Granted, just typing perldoc gets you started,
> but it's at least 3 steps before you start getting close to your answer
> (1-perldoc, 2-perldoc perl, 3-perldoc perlvar), which is too slow for
> anybody born after 1975.
snip

I guess that is why it doesn't bother me, I was born in 1974.

snip
> Okay, bottom line, it's a skill that's not easy.
snip

Learning to research anything is not easy.  Knowing where to look and
what to look for is hard.  We do what we can (see what they are doing
in the [Padre][1] project).  People are thinking about this and making
changes.  One guy is updating all of the code in the docs to [modern
versions][2].

snip
> But why not change perldoc to default to an index search, e.g. "perldoc
> '$.'" takes you right to the right place in the docs.  Easy for me to
> suggest, I don't have near the skill level to actually do it myself -- but
> just a suggestion for those who do.
snip

Because deciding what the user wants is difficult.  Perldoc now has -f
and -v switches to give you functions and variable information.  If I
have my way it will have a new switch to tell you about operators (if
I can get perlopref into the core).

[1] : http://padre.perlide.org
[2] : http://www.nntp.perl.org/group/perl.perl5.porters/2009/08/msg150395.html

-- 
Chas. Owens
wonkden.net
The most important skill a programmer can have is the ability to read.

--
To unsubscribe, e-mail: beginners-unsubscr...@perl.org
For additional commands, e-mail: beginners-h...@perl.org
http://learn.perl.org/


Reply via email to