Hi all,
Peter reported a bug to debian concerning the fact that we distribute a
PostgreSQL documentation with pgAdmin III. You can find the full
bugreport here:
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=245310
Here are the problems:
* The copyright acknowledgement for the PostgreSQL documentation (may be
I missed it while packaging the stuff... If not, we may add it to CVS).
* The documentation we provide with the PostgreSQL package can duplicate
one from another debian package (postgresql-doc) which can come to a
waste of space and to outdated documentation.
My answer to this follow this mail and I'd like to hear your mind on the
topic.
Another thing: how are the *.hh[ckp] files generated ? Is there a way to
build these files automatically ?
Regards,
Raphaël
My previous answer:
Peter Eisentraut wrote:
> The package pgadmin3-data contains the PostgreSQL documentation in
> /usr/share/pgadmin3/docs/en_US/pg/. The same files are also available
> in the package postgresql-doc. This not only wastes space, it might
> get outdated (or forward dated) with respect to the PostgreSQL version
> actually installed. Maybe this requires an upstream solution or maybe
> it is sufficient to solve this in Debian, but it doesn't seem right
> anyway.
>
>
mmmh I'm not sure we can achieve a real good solution concerning this
particular point:
you can use pgAdmin III on a debian box as a client to a PostgreSQL
server located on another box with another PostgreSQL version than the
one distributed with debian (that's particularly the case in woody
backports for example...).
I see the documentation provided with pgAdmin III as a feature of the
product in itself. Note that you can change the help system location to
wherever you want and so refer to a locally installed
documentation...But unless we solve the other point you mention further
(*.hh[ckp] files) people won't have the search/index/... facilities.
If I'd suggest the postgresql-doc package instead of distributing
pgAdmin III upstream files I would have exactly the same problem: these
files could be outdated or forward dated if using another version of
PostgreSQL on another box...
> The copyright acknowledgement for the PostgreSQL documentation is
> furthermore missing from /usr/share/doc/pgadmin3-data/copyright.
>
>
Can you help me regarding this: what kind of thing should I add ? A
separate file ? A reference directly inside the pgAdmin III copyright
file ? Shall I forward such modifications to upstream pgAdmin team (I
bet yes) ?
> I am aware that there are some special index files that are tuned to
> this particular version of the PostgreSQL documentation: *.hhc, *.hhk,
> *.hhp. But it should be possible to recreate these at build time. (If
> not, then we really have a problem, because these are clearly machine-
> generated files, and we must have a way to recreate them.)
>
>
I'm forwarding your report and my answer to pgadmin-hackers ML so that
upstream can help finding a good and reliable solution.
