Re: Patch to readd documentation

Kris Jurka wrote:
> Well, we will certainly have to produce a source package. My
> understanding is that even for the main tree the packager doesn't
> produce the documentation from source, but simply uses a provided
> .tar.gz file of the html doc. This seems like a reasonable thing to
> do as well (although I can't say I understand putting a compressed
> archive inside of a compressed archive.) Where these actually go is
> up to the actual packager.

The traditional approach for a source package is to prebuild as much as
you can while remaining portable. Typically, this includes things like
yacc, and it certainly includes the documentation. So far, the JDBC
driver hasn't had anything it could prebuild before shipping a source
package, so currently there is no difference between CVS and a source
package. But it seems like a good time to start.

Btw., the only reason that the server package pulls these tricks with
the documentation is so that you can still build snapshot source
packages when the documentation happens to be broken. I wouldn't worry
about that. Before long we'll have the documentation build worked out
and it will run like a clockwork.

> We could certainly produce a "packager's package" which contained the
> prebuilt jar files and documentation. Packaging instructions are
> great, but what we'll really need to do is advertise our availability
> to help and be responsive to maintainers.

Just put the spec files in your CVS and be your own maintainer. That
way you keep everything under control.