Re: pgsql: First pass over release documentation. - Mailing list pgsql-committers

From Bruce Momjian
Subject Re: pgsql: First pass over release documentation.
Date
Msg-id 200710180640.l9I6et419487@momjian.us
Whole thread Raw
List pgsql-committers
bruce wrote:
> Neil Conway wrote:
> > On Thu, 2007-10-18 at 02:06 -0400, Bruce Momjian wrote:
> > > I have made the details match what we usually do for level of detail in
> > > the release notes.
> >
> > WRT the overview, I'm not sure what a user is supposed to make of an
> > overview bullet point like "Use pseudo-transaction ids in read-only
> > transactions". If we're going to mention this at all, we ought to
> > include enough information for it to be sensible -- or else phrase it in
> > less technical terms ("Improve performance of read-only transactions by
> > lazily assigning transaction IDs"). Similar comments apply to the "ORDER
> > BY ... LIMIT" optimization, async commit, distributed checkpoint I/O,
> > etc.
>
> Agreed.  I need to make it more targeted at the benefit, like "reduce
> need for vacuuming caused by read-only transactions".  You are looking
> at only my first cut at edits.
>
> > For the "Migration to 8.3" section, I think we definitely need a lot
> > more details than are presently there ("New C macros for handling
> > variable-length data values" is not exactly very useful, for example).
>
> The detail is below.

I see in 8.2 I had the migration stuff all in one section with the
detail and didn't mention it again below.  I will follow that pattern
for 8.3 and do more adjustments tomorrow.

--
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://postgres.enterprisedb.com

  + If your life is a hard drive, Christ can be your backup. +

pgsql-committers by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: pgsql: First pass over release documentation.
Next
From: dpage@pgfoundry.org (User Dpage)
Date:
Subject: pginstaller - pginst: Re-enable support for UTF8 now that the server