Re: Release notes

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Neil Conway <neilc(at)samurai(dot)com>, Alvaro Herrera <alvherre(at)commandprompt(dot)com>, Robert Treat <xzilla(at)users(dot)sourceforge(dot)net>, pgsql-hackers(at)postgresql(dot)org
Subject: Re: Release notes
Date: 2006-09-14 22:53:38
Message-ID: 200609142253.k8EMrcr14977@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Tom Lane wrote:
> Bruce Momjian <bruce(at)momjian(dot)us> writes:
> > How is maintaining another file on every commit going to go over?
>
> If memory serves, we tried this before --- back in the 7.4 devel cycle,
> people were supposed to add small entries to release.sgml every time
> they committed something worth mentioning in the release notes. This
> was not done anywhere near consistently enough to be useful, however,
> and so we gave it up. ISTR that we had patch-merging problems too,
> because any patch submitters who took it seriously were trying to patch
> the same chunk of release.sgml.
>
> I tend to agree with Bruce that it's more efficient to go through the
> CVS logs once than to try to do the work incrementally. We should
> encourage people to write commit messages that are sufficient for the
> release notes, but folding the text into release.sgml immediately
> doesn't seem all that important.

Another complexity is that when you are going through the logs in 1-3
days, you remember all the information and can adjust things so they are
consistent. I have certain rules of determining what items are worthy,
what are not, and what have to be merged into a single entry. Having
individuals do that is harder.

--
Bruce Momjian bruce(at)momjian(dot)us
EnterpriseDB http://www.enterprisedb.com

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

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Jeff Davis 2006-09-14 23:40:17 Re: [ADMIN] Vacuum error on database postgres
Previous Message Tom Lane 2006-09-14 22:47:27 Re: Release notes