[Fwd: Re: Bug#245310: pgadmin3-data: pgadmin3 ships duplicate of PostgreSQL]

From: Raphaël Enrici <blacknoz(at)club-internet(dot)fr>
To: pgadmin-hackers(at)postgresql(dot)org
Cc: Peter Eisentraut <peter_e(at)gmx(dot)net>
Subject: [Fwd: Re: Bug#245310: pgadmin3-data: pgadmin3 ships duplicate of PostgreSQL]
Date: 2004-04-22 17:40:19
Message-ID: 40880383.4090708@club-internet.fr
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgadmin-hackers

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.

Browse pgadmin-hackers by date

  From Date Subject
Next Message Dave Page 2004-04-23 07:32:30 Re: [Fwd: Re: Bug#245310: pgadmin3-data: pgadmin3 ships duplicate of PostgreSQL]
Previous Message Peter Eisentraut 2004-04-22 12:41:20 Smoother PostgreSQL icons