Re: 9.5 release notes

On Sat, Jun 13, 2015 at 07:52:22AM -0300, Alvaro Herrera wrote:
> Bruce Momjian wrote:
> > I have committed the first draft of the 9.5 release notes.  You can view
> > the output here:
> >
> >     http://momjian.us/pgsql_docs/release-9-5.html
> >
> > and it will eventually appear here:
> >
> >     http://www.postgresql.org/docs/devel/static/release.html
> >
> > I am ready to make suggested adjustments, though I am traveling for
> > conferences for the next ten days so there might a delay in my replies.
>
> Many people have commented on the "RETURN WHERE" text.  The item in
> question is this:
>     Have CREATE TABLE AS and REFRESH return an OID
>
> This code was later changed to return ObjectAddress rather than OID;
> this is used to feed event triggers.  To answer the "where" question:
> the OID is returned to ProcessUtilitySlow, where it can be used by the
> DDL-command-collection infrastructure.
>
> I don't think this particular change needs a mention in the release
> notes, since the ddl command collection is mentioned separately.  I
> would just remove it.

OK, removed.

> In the pg_upgrade section, I think this is a bit strangely worded:
>     Remove pg_upgrade support for 8.3 old clusters (Bruce Momjian)
> How about this?
>     Remove support for upgrading from 8.3 clusters (Bruce Momjian)
>
> Why do we need a separate mention that pg_upgrade_support was moved to
> backend in the "Additional Modules" section?  Seems to me that having
> it mentioned in the pg_upgrade section would be better.

OK, moved.

> This entry is missing a word at the end:
>     Allow CURRENT/SESSION_USER to specify the current user in
>     certain

OK, wording updated, applied patch attached.

Thanks for the review.
--
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

  + Everyone has their own god. +