Re: [gentoo-dev] Re: perl eclass review - EAPI=3 + new helper eclass

[Fabian Groffen]

On 12-04-2010 10:07:54 +0200, Christian Faulhammer wrote:
> > if [[ -d ${D}/${VENDOR_LIB} ]] ; then
> 
>  Haven't checked, but quotes not needed?

it's within [[ ]], so no.


-- 
Fabian Groffen
Gentoo on a different level

Re: [gentoo-dev] Re: perl eclass review - EAPI=3 + new helper eclass

[James Cloos]

> "D" == Duncan  <1i5t5.dun...@cox.net> writes:

D> While you're correct in the ordinary case, keep in mind that this is perl 
D> developer docs we're talking about here -- not ordinary user documentation.

Developer docs *are* ordinary user documentation.  Section 3 is perhaps
the most used section of man, with sections 2 and, depending on platform,
one or more of sections 4, 5 or 6 following.

D> And those that know enough about perl to find the developer documentation 
D> useful should also know how to use perldoc,

You are ignoring the fact that having the docs in man is more useful;
much easier to use, usable by any man reader.  The list goes on.

There is simply no *real* benefit to eliding them, it only does harm.

People who do not want to install them should specify that preference
via a USE flag (-man, perhaps).

It would even be OK were the USE flag off by default; but making it
impossible to Do The Right Thing w/o editing eclasses every time one
syncs is just wrong.

-JimC
-- 
James Cloos  OpenPGP: 1024D/ED7DAEA6

Re: [gentoo-dev] Re: perl eclass review - EAPI=3 + new helper eclass

[James Cloos]

> "MG" == Michał Górny  writes:

MG> I prefer perldoc over man. And I cannot imagine why anyone would prefer
MG> keeping two copies of the same docs if generating one from another
MG> takes less than a second.

It takes more than a mere second, and man(1), man.el, woman.el and the
like have better UIs than perldoc(1) has.

-JimC
-- 
James Cloos  OpenPGP: 1024D/ED7DAEA6

Re: [gentoo-dev] Re: perl eclass review - EAPI=3 + new helper eclass

[Michał Górny]

On Tue, 06 Apr 2010 10:25:27 -0400
James Cloos  wrote:

> Perl people -- I'm one -- use man(1); given the differences in
> usefulness, I cannot imagine why anyone would prefer perldoc(1)
> over man(1).

I prefer perldoc over man. And I cannot imagine why anyone would prefer
keeping two copies of the same docs if generating one from another
takes less than a second.

-- 
Best regards,
Michał Górny





signature.asc
Description: PGP signature

Re: [gentoo-dev] Re: perl eclass review - EAPI=3 + new helper eclass

[James Cloos]

> "MH" == Michael Higgins  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.

-JimC
-- 
James Cloos  OpenPGP: 1024D/ED7DAEA6

Re: [gentoo-dev] Re: perl eclass review - EAPI=3 + new helper eclass

[James Cloos]

> "TV" == Torsten Veller  writes:

TV> * James Cloos :
>> One change the perl eclasses require is elimination of the code which
>> deletes the man pages.
>> 
>> Deleting the man pages is /extremely/ rude and should not occur.

TV> There was a reason why the man-pages were removed: I think it was
TV> collisions protection and perl people use `perldoc` anyway.

Perl people -- I'm one -- use man(1); given the differences in
usefulness, I cannot imagine why anyone would prefer perldoc(1)
over man(1).

TV> Do we need a patch to avoid collisions? Do you have it ready and tested?

I've never seen any collisions due to installing the man pages.

-JimC
-- 
James Cloos  OpenPGP: 1024D/ED7DAEA6

Re: [gentoo-dev] Re: perl eclass review - EAPI=3 + new helper eclass

[Michael Higgins]

On Sat, 3 Apr 2010 12:33:48 +0200
Torsten Veller  wrote:

>  perl people use `perldoc` anyway.

Yep. Why have a man page for a perl module? OTOH, if there is something
that goes in /usr/bin, it should get a man page if there is one. But
not for the modules themselves -- that's not needed at all.

Just my $0.02.

-- 
 |\  /||   |  ~ ~  
 | \/ ||---|  `|` ?
 ||ichael  |   |iggins\^ /
 michael.higgins[at]evolone[dot]org