[GENERAL] Documentation - PgAdmin
db.subsc...@shepherdhill.biz
Congratulations on the release of version 8.4.
I am surprised that pgAdmin's help link is now directed to the
documentation website of postgresql. The embedded help CHM was not
packaged with it.
This implies that anytime one needs help on a simple syntax, one must
connect to the internet.
Was this by design or omission?
Regards,
Chris
--
Sent via pgsql-general mailing list (pgsql-...@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-general
justin
Hi,
Congratulations on the release of version 8.4.
I am surprised that pgAdmin's help link is now directed to the documentation website of postgresql. The embedded help CHM was not packaged with it.
This implies that anytime one needs help on a simple syntax, one must connect to the internet.
Was this by design or omission?
Regards,
Chris
http://www.postgresql.org/docs/manuals/
I'm not sure about Enterprise DB package as it includes pgAdmin and may have CHM file along for the ride
Raymond O'Donnell
> db.subsc...@shepherdhill.biz wrote:
>> I am surprised that pgAdmin's help link is now directed to the
>> documentation website of postgresql. The embedded help CHM was not
>> packaged with it.
> CHM has not been packaged for as long as i know of with PgAdmin..
> http://www.postgresql.org/docs/manuals/
You can, however, download the help file separately from the PostgreSQL
site, and then point pgAdmin at the local copy.
Ray.
------------------------------------------------------------------
Raymond O'Donnell, Director of Music, Galway Cathedral, Ireland
r...@iol.ie
Galway Cathedral Recitals: http://www.galwaycathedral.org/recitals
------------------------------------------------------------------
Justin Graf
Now the MSI installers from Enterprise DB is a One Click installer i'm not sure whats all included. I have it installed on one or 2 machines but never really dug into what's all included to tell you what all in the new installer.
but the the pgAdmin installer from here
http://www.postgresql.org/ftp/pgadmin3/release/v1.10.0/win32/
As far I can think back this installer never included CHM. I found it annoying but given this supports multiple versions of PG which CHM file does one include.
---- Message from db.subsc...@shepherdhill.biz at 07-05-2009 07:14:49 AM ------
Quoting justin <jus...@emproshunts.com>:
> CHM has not been packaged for as long as i know of with PgAdmin..
Justin,
Are you sure?
Windows help file CHM has been the default help file that pgAdmin
opens when you click on the help icon on the toolbar of pgAdmin
(uptill Postgresql's version 8.3.7) using MSI installer.
Or are you saying the MSI package maintainers included the CHM files
and not pgAdmin packagers? If that is the case, I should direct my
question to EnterpriseDB who is the new windows binary maintainer.
Regards,
Chris
Raymond O'Donnell
> but the the pgAdmin installer from here
> http://www.postgresql.org/ftp/pgadmin3/release/v1.10.0/win32/
> As far I can think back this installer never included CHM. I found it
> annoying but given this supports multiple versions of PG which CHM file
> does one include.
As I recall, the pgInstaller did at one time include the .chm file;
however, as you say, it's been a number of years since that was the case.
I can't remember what the reason was for dropping it from the installer
- it may have been problems with building the .chm file in the first place.
Ray.
------------------------------------------------------------------
Raymond O'Donnell, Director of Music, Galway Cathedral, Ireland
r...@iol.ie
Galway Cathedral Recitals: http://www.galwaycathedral.org/recitals
------------------------------------------------------------------
--
Sachin Srivastava
over the last 3 years i can't recall it being included in the msi installer
Now the MSI installers from Enterprise DB is a One Click installer i'm not sure whats all included. I have it installed on one or 2 machines but never really dug into what's all included to tell you what all in the new installer.
but the the pgAdmin installer from here
http://www.postgresql.org/ftp/pgadmin3/release/v1.10.0/win32/
As far I can think back this installer never included CHM. I found it annoying but given this supports multiple versions of PG which CHM file does one include.
---- Message from db.subsc...@shepherdhill.biz at 07-05-2009 07:14:49 AM ------Quoting justin <jus...@emproshunts.com>:
> CHM has not been packaged for as long as i know of with PgAdmin..
Justin,
Are you sure?
Windows help file CHM has been the default help file that pgAdmin
opens when you click on the help icon on the toolbar of pgAdmin
(uptill Postgresql's version 8.3.7) using MSI installer.
Or are you saying the MSI package maintainers included the CHM files
and not pgAdmin packagers? If that is the case, I should direct my
question to EnterpriseDB who is the new windows binary maintainer.
Regards,
Chris
-- Regards, Sachin Srivastava www.enterprisedb.com
Guillaume Lelarge
> On 05/07/2009 18:14, Justin Graf wrote:
> > but the the pgAdmin installer from here
> > http://www.postgresql.org/ftp/pgadmin3/release/v1.10.0/win32/
> > As far I can think back this installer never included CHM. I found it
> > annoying but given this supports multiple versions of PG which CHM file
> > does one include.
>
> As I recall, the pgInstaller did at one time include the .chm file;
> however, as you say, it's been a number of years since that was the case.
>
> I can't remember what the reason was for dropping it from the installer
> - it may have been problems with building the .chm file in the first place.
>
If I remember well, the reason was the installer would be much bigger if we
still included it. And we would also have to carry the pgAdmin CHM, and the
Slony one, and the EnterpriseDB one and now the Greenplum one. And what about
translations? If we do this, 90% of the installer size would be for docs. Kind
of strange if you want my opinion.
The way we do it now allows you to read the docs on the Internet. But you can
grab of copy of those, put them on your hard disk, and change the preferences
to show them instead of the internet ones.
--
Guillaume.
http://www.postgresqlfr.org
http://dalibo.com
Dave Page
> If I remember well, the reason was the installer would be much bigger if we
> still included it. And we would also have to carry the pgAdmin CHM, and the
> Slony one, and the EnterpriseDB one and now the Greenplum one. And what about
> translations? If we do this, 90% of the installer size would be for docs. Kind
> of strange if you want my opinion.
Yeah, that's a major part of it. The manual hasn't been in pgAdmin for
something like 15 months. This is because:
- It's difficult and error-prone to merge the manuals into one CHM file
- We (== I) had to update the CHM file whenever PostgreSQL or Slony was updated.
- Bundling the manual bloated the distribution size
- Bundling the manual pretty much prevented the manual being translated.
- The bundled manual was no use unless you used the latest version of
PostgreSQL.
- The bundled manual was of little use to EnterpriseDB or Greenplum users.
> The way we do it now allows you to read the docs on the Internet. But you can
> grab of copy of those, put them on your hard disk, and change the preferences
> to show them instead of the internet ones.
Yes - in fact it's even more flexible than that:
PG help path - This option is used to specify the path to the
PostgreSQL help files. This may be a URL or directory containing the
HTML format help files (note that some browsers may require
file:///path/to/local/files/ notation, whilst others require
/path/to/local/files/ notation), or the path to a Compiled HTML Help
(.chm) file (on Windows), an HTML Help project (.hhp) file, or a Zip
archive containing the HTML files and the HTML Help project file. The
PostgreSQL Help is used when selected from the Help menu, or when
working with many database objects on PostgreSQL servers.
Similar options are present for EnterpriseDB, Greenplum and Slony help.
--
Dave Page
EnterpriseDB UK: http://www.enterprisedb.com