> This would be one way. The other would be to put the doc in it's own
> space. Some reasons:
> 1. Can ggi be installed separate from gii? No so usually you need the
> docs for both
GII can be installed separate from GGI. I strongly believe most docs (like
manpages etc.) should come with the package. Keeping docs and code in sync is
very important.
> 3. You often don't need the docs. If you just want to update the code
> (latest snapshot) downloading the docs would just cause more traffic and
> higher phonebills.
Use CVS or diffs, then. Docs that don't change don't take up bandwidth
there.
> My suggestion would be to put the docs into a separate tree.
No. That would call for them getting out of sync with the code.
> IMHO only sources should go into cvs. SGML/XML is a source format.
> Everything that can be derived from that shouldn't go into cvs (or would
> you commit binaries into cvs?).
Correct.
We do pregenerate some files when making the snaps from CVS (./configure),
to avoid nondevelopers having to have auto* installed, but that's another
story.
> But the different formats of documentation should be put onto the server
> for download.
Yeah. That would be a good idea for those that have problems with generation
of the format they want.
> Btw checking out the cvs tree would take more time, traffic, phonebill....
Yeah - as you said - CVS is for sources.
CU, ANdy
--
= Andreas Beck | Email : <[EMAIL PROTECTED]> =
