Skip site navigation (1) Skip section navigation (2)

[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 (view raw or flat)
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.


pgadmin-hackers by date

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

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group