Thread: Website Documentation

Website Documentation

From
Russell Smith
Date:
Dear all,

There does not seems to be the latest version of the PostgreSQL documentation online.

The release notes for 8.0 and 7.4 only go to version 8.0.0 and 7.4.6.

Where can I find the changes made from 7.4.6 -> 7.4.7, and 8.0.0 -> 8.0.1?

Should the site be updates?

Thanks

Russell Smith

Re: Website Documentation

From
Bruce Momjian
Date:
Russell Smith wrote:
> Dear all,
>
> There does not seems to be the latest version of the PostgreSQL documentation online.
>
> The release notes for 8.0 and 7.4 only go to version 8.0.0 and 7.4.6.
>
> Where can I find the changes made from 7.4.6 -> 7.4.7, and 8.0.0 -> 8.0.1?

If you want the changes to the server between releases see the Release
notes in the documentation.  8.0.1 release notes contain all changes
back to the 1.0 release.

If you want to know the documentation changes between releases, we don't
track that except via CVS logs.

--
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 359-1001
  +  If your life is a hard drive,     |  13 Roberts Road
  +  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073

Re: Website Documentation

From
"Joshua D. Drake"
Date:
Russell Smith wrote:

>Dear all,
>
>There does not seems to be the latest version of the PostgreSQL documentation online.
>
>The release notes for 8.0 and 7.4 only go to version 8.0.0 and 7.4.6.
>
>Where can I find the changes made from 7.4.6 -> 7.4.7, and 8.0.0 -> 8.0.1?
>
>Should the site be updates?
>
>
I believe (I would have to double check) that 8.0.1 was just a security
release and that there are no differences in actual usage.

Sincerely,

Joshua D. Drake



>Thanks
>
>Russell Smith
>
>---------------------------(end of broadcast)---------------------------
>TIP 8: explain analyze is your friend
>
>


--
Command Prompt, Inc., home of Mammoth PostgreSQL - S/ODBC and S/JDBC
Postgresql support, programming shared hosting and dedicated hosting.
+1-503-667-4564 - jd@commandprompt.com - http://www.commandprompt.com
PostgreSQL Replicator -- production quality replication for PostgreSQL


Attachment

Re: Website Documentation

From
Tom Lane
Date:
Bruce Momjian <pgman@candle.pha.pa.us> writes:
> Russell Smith wrote:
>> The release notes for 8.0 and 7.4 only go to version 8.0.0 and 7.4.6.

> If you want the changes to the server between releases see the Release
> notes in the documentation.

I think his point is that those notes aren't up on the website.  We
should make a regular practice of updating the on-line docs to match
each minor release, even if nothing changed except the release notes
(which is often not the case, anyway).

            regards, tom lane

Re: Website Documentation

From
Russell Smith
Date:
On Sun, 13 Feb 2005 01:22 pm, Bruce Momjian wrote:
> Russell Smith wrote:
> > Dear all,
> >
> > There does not seems to be the latest version of the PostgreSQL documentation online.
> >
> > The release notes for 8.0 and 7.4 only go to version 8.0.0 and 7.4.6.
> >
> > Where can I find the changes made from 7.4.6 -> 7.4.7, and 8.0.0 -> 8.0.1?
>
> If you want the changes to the server between releases see the Release
> notes in the documentation.  8.0.1 release notes contain all changes
> back to the 1.0 release.
>
I am aware of this, but the 8.0.1 release notes are not online.  I assume we are saying
I have to download them to view them.  This may be correct now, but in the past that doesn't
seem to have been the case.

http://www.postgresql.org/docs/8.0/interactive/release.html

Has all releases, including 7.4.6  and the changes to 7.4.5, but none of these appear to be
available for the most recent release (eg 7.4.7, 7.3.9 and 8.0.1)  I know they may have been
only security release, but I assumed that the release notes would say what security bugs
those versions fixed.

But I could be all wrong about this too.

Regards

Russell Smith

> If you want to know the documentation changes between releases, we don't
> track that except via CVS logs.
>

Re: Website Documentation

From
Bruno Wolff III
Date:
On Sun, Feb 13, 2005 at 13:06:52 +1100,
  Russell Smith <mr-russ@pws.com.au> wrote:
> Dear all,
>
> There does not seems to be the latest version of the PostgreSQL documentation online.
>
> The release notes for 8.0 and 7.4 only go to version 8.0.0 and 7.4.6.
>
> Where can I find the changes made from 7.4.6 -> 7.4.7, and 8.0.0 -> 8.0.1?
>
> Should the site be updates?

They should probably be somewhere else as well, but you can find the
information in the developer version of the docs at:
http://developer.postgresql.org/docs/postgres/release.html#RELEASE-8-0-1

Re: Website Documentation

From
Russell Smith
Date:
On Sun, 13 Feb 2005 01:45 pm, Tom Lane wrote:
> Bruce Momjian <pgman@candle.pha.pa.us> writes:
> > Russell Smith wrote:
> >> The release notes for 8.0 and 7.4 only go to version 8.0.0 and 7.4.6.
>
> > If you want the changes to the server between releases see the Release
> > notes in the documentation.
>
> I think his point is that those notes aren't up on the website.  We
> should make a regular practice of updating the on-line docs to match
> each minor release, even if nothing changed except the release notes
> (which is often not the case, anyway).
>
What Tom has understood is what I meant.  Also thanks to Bruno for the link
to the developer docs, where the 8.0.1 release information is.

Regards

Russell Smith.

>    regards, tom lane
>
> ---------------------------(end of broadcast)---------------------------
> TIP 4: Don't 'kill -9' the postmaster
>
>

Re: Website Documentation

From
Bruce Momjian
Date:
Tom Lane wrote:
> Bruce Momjian <pgman@candle.pha.pa.us> writes:
> > Russell Smith wrote:
> >> The release notes for 8.0 and 7.4 only go to version 8.0.0 and 7.4.6.
>
> > If you want the changes to the server between releases see the Release
> > notes in the documentation.
>
> I think his point is that those notes aren't up on the website.  We
> should make a regular practice of updating the on-line docs to match
> each minor release, even if nothing changed except the release notes
> (which is often not the case, anyway).

Uh, my next question is why isn't the documentation updated on the web
site for each minor release?  We update the tarball HTML for each
release.  This seems like a pretty large omission.

Is it the web comments that prevent it?

--
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 359-1001
  +  If your life is a hard drive,     |  13 Roberts Road
  +  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073