[Catalyst-dev] PPM Catalyst/Manual.html clash.

[Emanuele Zeppieri]

Matt S Trout wrote:

>> Just drop Manual.pod from Catalyst::Runtime, because Catalyst will be 
>> cleaner ;-)
> 
> We tried that. New users didn't realise the manual existed.

Really?!

Wasn't "See L<Catalyst::Manual> for more documentation." in 
Catalyst.pm's POD sufficient?

I can't imagine a user who didn't understand that (not even a Windows 
user ;-)

> And we can't drop the .pm from ::Manual because then CPAN.pm wouldn't know
> to install it.

I did not suggest that, indeed.

> I'd love to make it easier for you to install Catalyst using your chosen
> closed source GUI tool, but not at the expense of everybody using the standard
> free software solutions for perl deployment.

Nor Windows nor ActivePerl are my platforms of choice, though I feel no 
particular perverse pleasure in boycotting them.

Seriously, placing a fake file in Catalyst::Runtime just to say: "Hey 
man, look, there is also a Catalyst Manual!" is not a good idea IMO.
Then incidentally it also causes that problem with PPM, so you 
ultimately get two damages at once...

Believe it or not, I suggested that *only* pro Catalyst and its spread 
among the greatest possible number of users (regardless of the platform 
they use).

Cheers,
Emanuele.