Re: Patch to readd documentation

Поиск
Список
Период
Сортировка
От Peter Eisentraut
Тема Re: Patch to readd documentation
Дата
Msg-id 200401271950.04792.peter_e@gmx.net
обсуждение исходный текст
Ответ на Re: Patch to readd documentation  (Kris Jurka <books@ejurka.com>)
Список pgsql-jdbc
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.


В списке pgsql-jdbc по дате отправления:

Предыдущее
От: Kris Jurka
Дата:
Сообщение: Re: Patch to readd documentation
Следующее
От: Bhushan Bhangale
Дата:
Сообщение: Re: jdbc connection string