Website Documentation

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

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

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

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

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

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.

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

-----Original Message-----
From: pgsql-www-owner@postgresql.org
[mailto:pgsql-www-owner@postgresql.org] On Behalf Of Bruce Momjian
Sent: 13 February 2005 15:16
To: Tom Lane
Cc: Russell Smith; pgsql-general@postgresql.org;
pgsql-www@postgresql.org
Subject: Re: [pgsql-www] [GENERAL] Website Documentation

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?

No, it's my free time, and if I'm honest, the fact that I usually forget
all about it (perhaps a reminder email could be added to the release
procedure?). It's on my list to do now anyway - hopefully I'll get it
done this week, however I'm off to Japan on Wednesday so if I haven't
done it by then it'll be mid-to-late the following week.

Regards, Dave.

Dave Page wrote:

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?

No, it's my free time, and if I'm honest, the fact that I usually forget
all about it (perhaps a reminder email could be added to the release
procedure?). It's on my list to do now anyway - hopefully I'll get it
done this week, however I'm off to Japan on Wednesday so if I haven't
done it by then it'll be mid-to-late the following week.

Agreed. Who controls the release procedure checklist? Marc?

-- 
  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

-----Original Message-----
From: Bruce Momjian [mailto:pgman@candle.pha.pa.us]
Sent: 13 February 2005 18:12
To: Dave Page
Cc: Tom Lane; Russell Smith; pgsql-general@postgresql.org;
pgsql-www@postgresql.org
Subject: Re: [pgsql-www] [GENERAL] Website Documentation

Agreed. Who controls the release procedure checklist? Marc?

I thought you did :-)

/D

Dave Page wrote:

-----Original Message-----
From: Bruce Momjian [mailto:pgman@candle.pha.pa.us]
Sent: 13 February 2005 18:12
To: Dave Page
Cc: Tom Lane; Russell Smith; pgsql-general@postgresql.org;
pgsql-www@postgresql.org
Subject: Re: [pgsql-www] [GENERAL] Website Documentation

Agreed. Who controls the release procedure checklist? Marc?

I thought you did :-)

Uh, I do the release changes list. I think we need to add the rebuild
to the release "packaging" checklist which I think Marc deals with.

-- 
  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

Dave Page wrote:

-----Original Message-----
From: Bruce Momjian [mailto:pgman@candle.pha.pa.us]
Sent: 13 February 2005 18:12
To: Dave Page
Cc: Tom Lane; Russell Smith; pgsql-general@postgresql.org;
pgsql-www@postgresql.org
Subject: Re: [pgsql-www] [GENERAL] Website Documentation

Agreed. Who controls the release procedure checklist? Marc?

I thought you did :-)

Who's on first??

--
Until later, Geoffrey

On Sun, 13 Feb 2005, Bruce Momjian wrote:

Dave Page wrote:

-----Original Message-----
From: Bruce Momjian [mailto:pgman@candle.pha.pa.us]
Sent: 13 February 2005 18:12
To: Dave Page
Cc: Tom Lane; Russell Smith; pgsql-general@postgresql.org;
pgsql-www@postgresql.org
Subject: Re: [pgsql-www] [GENERAL] Website Documentation

Agreed. Who controls the release procedure checklist? Marc?

I thought you did :-)

Uh, I do the release changes list. I think we need to add the rebuild
to the release "packaging" checklist which I think Marc deals with.

I have a script that has been added to over time to make sure steps
aren't missed ... jumping into this thread late, but checking the
archives, I'm hoping that I'm on the right part of the thread :)

Namely, I somehow need to add in a procedure to take the postgres.tar.gz
file that gets auto-generated by the release packaging, and have it update
the online docs ... looking at http://www.postgresql.org/docs, the only
time that the web site itself is on a major release, so ...

What do I need to checkout, and from where, to do the updates?

----
Marc G. Fournier Hub.Org Networking Services (http://www.hub.org)
Email: scrappy@hub.org Yahoo!: yscrappy ICQ: 7615664

Marc G. Fournier wrote:

Uh, I do the release changes list. I think we need to add the rebuild
to the release "packaging" checklist which I think Marc deals with.

I have a script that has been added to over time to make sure steps
aren't missed ... jumping into this thread late, but checking the
archives, I'm hoping that I'm on the right part of the thread :)

Yep.

Namely, I somehow need to add in a procedure to take the postgres.tar.gz
file that gets auto-generated by the release packaging, and have it update
the online docs ... looking at http://www.postgresql.org/docs, the only
time that the web site itself is on a major release, so ...

What do I need to checkout, and from where, to do the updates?

I think you just need to take the postgres HTML tarball and dump it into
the 8.0 directory for every 8.0.X release. You don't need to update the
web page itself because it is really the 8.0.X docs, not the 8.0.0 docs
listed on that page.

-- 
  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

-----Original Message-----
From: pgsql-www-owner@postgresql.org
[mailto:pgsql-www-owner@postgresql.org] On Behalf Of Tom Lane
Sent: 13 February 2005 02:45
To: Bruce Momjian
Cc: Russell Smith; pgsql-general@postgresql.org;
pgsql-www@postgresql.org
Subject: Re: [pgsql-www] [GENERAL] Website Documentation

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).

Docs updated to 7.2.7, 7.3.9, 7.4.7 & 8.0.1. Will propagate to the front
end servers within a few hours.

Regards, Dave.