Re: documentation bug?

Karl Fogel <kfogel@newton.ch.collab.net> writes:

> I think we're going to have the docs available online (see
> www.python.org for an example) soon, so it won't be necessary for
> ordinary users to run 'make doc'. Documentation developers will of
> course need to do so, but then they'll have a motivation to install
> the necessary tools.

Normally, generated documentation files are shipped in the distribution
tar file. This is good practice because the user has everything
she needs right there, without having to run off to the web site
(less convenient) or installing documentation generation tools
(pain in the ass). It's the same logic that leads to shipping the
configure script: users shouldn't have to have exotic tools installed.

Just my two cents :).

--
Eric Gillespie <*> epg@pretzelnet.org

Build a fire for a man, and he'll be warm for a day. Set a man on
fire, and he'll be warm for the rest of his life. -Terry Pratchett

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Mon Oct 14 15:36:14 2002