Re: pgsql: First pass over release documentation.

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