* [gentoo-dev] Re: perl eclass review - EAPI=3 + new helper eclass
@ 2010-04-06 14:52 99% ` Duncan
0 siblings, 0 replies; 1+ results
From: Duncan @ 2010-04-06 14:52 UTC (permalink / raw
To: gentoo-dev
James Cloos posted on Tue, 06 Apr 2010 10:27:36 -0400 as excerpted:
>>>>>> "MH" == Michael Higgins <linux@evolone.org> writes:
>
> MH> Yep. Why have a man page for a perl module? OTOH, if there is
> something MH> that goes in /usr/bin, it should get a man page if there
> is one. But MH> not for the modules themselves -- that's not needed at
> all.
>
> Because man(1) works better than the alternatives; it is the unix way;
> it is the first thing one types when searching for documentation.
>
> The idea that the man pages are somehow uneeded is incomprehensible.
While you're correct in the ordinary case, keep in mind that this is perl
developer docs we're talking about here -- not ordinary user documentation.
And those that know enough about perl to find the developer documentation
useful should also know how to use perldoc, while those that don't know
how to use perldoc, aren't likely to find the perl developer manpages of
much help, either; they'll be pretty much ordinary users, at least where
perl is concerned, and thus if anything, confused and irritated by all
those extra "useless" perl developer manpages.
--
Duncan - List replies preferred. No HTML msgs.
"Every nonfree program has a lord, a master --
and if you use the program, he is your master." Richard Stallman
^ permalink raw reply [relevance 99%]
Results 1-1 of 1 | reverse | options above
-- pct% links below jump to the message on this page, permalinks otherwise --
2010-03-30 11:11 [gentoo-dev] perl eclass review - EAPI=3 + new helper eclass Torsten Veller
2010-04-01 23:41 ` James Cloos
2010-04-03 10:33 ` [gentoo-dev] " Torsten Veller
2010-04-04 8:25 ` Michael Higgins
2010-04-06 14:27 ` James Cloos
2010-04-06 14:52 99% ` Duncan
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox