From: | Bruce Momjian <bruce(at)momjian(dot)us> |
---|---|
To: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
Cc: | Alvaro Herrera <alvherre(at)2ndquadrant(dot)com>, Andres Freund <andres(at)anarazel(dot)de>, PostgreSQL-development <pgsql-hackers(at)postgresql(dot)org> |
Subject: | Re: Adding commit details to SGML release notes |
Date: | 2015-08-28 21:49:35 |
Message-ID: | 20150828214935.GB18678@momjian.us |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-committers pgsql-hackers |
On Fri, Aug 28, 2015 at 05:32:38PM -0400, Tom Lane wrote:
> Alvaro Herrera <alvherre(at)2ndquadrant(dot)com> writes:
> > Bruce Momjian wrote:
> >> To simplify the creation of the release note with the commit tag as an
> >> SGML comment, I think src/tools/git_changelog should be modified to
> >> output this string. The format "trunc" feature was added in git 1.8.3.
> >> Is that old enough for everyone?
>
> > Since it's only needed by people preparing the release notes, I would
> > guess it's okay --- evidently Tom was able to use it.
>
> Well, that's only because I'm running a hand-installed git rather than
> what RHEL6 comes with.
Yes, I am running git 1.7.2.5 on Debian Squeeze, but I will be upgrading
in the next month, before the next major release notes are due, so I
would avoid the problem that way. :-)
> > Maybe an option is to use trunc when git 1.8.3 or newer is detected, and
> > plain (no trunc) otherwise?
>
> Personally I find that truncated output to be pretty unreadable, and
> would strongly object to changing git_changelog so that that was the only
> possible format. However, I have no objection to making it an option
> ("git_changelog --short", or so), and that would dodge any concerns about
> failing on git versions without the feature.
Well, my idea would be to change this git_changelog line:
Branch: master [01051a987] 2015-07-09 11:38:34 +0300
to output something in the new 'trunc' format, so we have it right next
to the release note text and the release notes easily get that comment.
If we _don't_ do that, how do you easily get those lines into the
release notes? I can't imagine how hard it was for Andres to add that
text to the 9.5 release notes:
http://www.postgresql.org/message-id/E1ZA0lx-0006FM-PU@gemulon.postgresql.org
--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ Everyone has their own god. +
From | Date | Subject | |
---|---|---|---|
Next Message | Tom Lane | 2015-08-28 22:03:15 | Re: Adding commit details to SGML release notes |
Previous Message | Tom Lane | 2015-08-28 21:32:38 | Re: Adding commit details to SGML release notes |
From | Date | Subject | |
---|---|---|---|
Next Message | Tom Lane | 2015-08-28 22:01:21 | Re: [BUGS] Compile fails on AIX 6.1 |
Previous Message | Tom Lane | 2015-08-28 21:32:38 | Re: Adding commit details to SGML release notes |