On Wed, Feb 25, 2004 at 02:55:16PM -0500, Bill Welliver wrote:
network connections. That it's available by default 1) encourages people to actually look at the documentation and see all of the wonderful
Really? :) Mostly, I install Pike on servers, i.e. I've no intention to read those autodocs later on all machines (frankly, I only read pregenerated docs, available separately or accessible on the website).
I guess, for those who build Pike first time, it _might_ be useful, however, in _most_ cases, this is unnecessary waste of space and build time. So:
a good compromise. Alternately, an optional install-without-docs target might suit as well.
In my opinion, the default must be to build _without_ docs. Those who like to read the docs will read the README or INSTALL first, where necessary instructions and explanations may be placed.
BTW, is this (autodoc generation) process fixed in 7.5? Few times I tried to build it and install (real install - i.e. not for verify target), and it hung somewhere in the middle, in endless loop generating recursive dirs (thus effectively blocking the build process)... :)
Regards, /Al