Hello,
Most Perl functions have some sort of entry available
for the user who learns how to type:
perldoc -f func_name
So perldoc -f sort (or map or grep) all return pretty
useful information.
I'm a little concerned that for the newer user, the qw()
entry:
perldoc -f qw
qw/STRING/
Generalized quotes. See "Regexp Quote-Like Operators" in
perlop.
is a little on the brutal side! (And the same is true for qx(), qq(), etc).
My thinking is this:
* The user has to work out how to find the
"Regexp Quote-Like Operators" section in perlop, and
* Then has to be motivated enough to go and do it. Now while
this is less trouble for people who are in an environment
where "Regexp Quote-Like Operators" is a hyperlink to that
section in the perlop page, (such as is the case on perldoc.perl.org
or in the activestate doco), it is nonetheless quite an
unecessary barrier for command line users.
I have two questions then:
1. What do you think about this?
2. If you agree that "perldoc -f qw" should return some
actual content about the qw function, should it be the
qw() content in perlop, or could it perhaps be something
simpler with a link at the bottom to the perlop content?
Regards,
Simon Taylor
