Re: PG 13 release notes, first draft

From: Fabien COELHO <coelho(at)cri(dot)ensmp(dot)fr>
To: Bruce Momjian <bruce(at)momjian(dot)us>
Cc: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Alvaro Herrera <alvherre(at)2ndquadrant(dot)com>, PostgreSQL-development <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: PG 13 release notes, first draft
Date: 2020-05-13 05:18:38
Message-ID: alpine.DEB.2.22.394.2005130707170.3283649@pseudo
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers


Hello Bruce,

>> * e1ff780485
>
> I was told in this email thread to not include that one.

Ok.

>> * 34a0a81bfb
>
> We already have:
>
> Reformat tables containing function information for better
> clarity (Tom Lane)
>
> so it seems it is covered as part of this.

AFAICR this one is not by the same author, and although the point was
about better clarity, it was not about formating but rather about
restructuring text vs binary string function documentations. Then Tom
reformatted the result.

>> * e829337d42
>
> Uh, this is a doc link formatting addition. I think this falls into the
> error message logic, where it is nice when people want it, but they
> don't need to know about it ahead of time.

Hmmm. ISTM that this is not really about "error message logic", it is
about navigating to libpq functions when one is reference in the
description of another to check what it does, which I had to do a lot
while developing some performance testing code for a project.

>> * "Document color support (Peter Eisentraut)"
>> THIS WAS NOT DOCUMENTED BEFORE?
>>
>> Not as such, AFAICR it was vaguely hinted about in the documentation of
>> command that would use it, but not even all of them. Now there is a new
>> specific section.
>
> Again, this is the first hash you gave.

Possibly, but as the "THIS WAS NOT DOCUMENTED BEFORE?" question seemed to
still be in the release notes, I gathered that the information had not
reached its destination, hence the possible repetition. But maybe the
issue is that this answer is not satisfactory. Sorry for the
inconvenience.

--
Fabien.

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message David G. Johnston 2020-05-13 05:26:46 Re: Event trigger code comment duplication
Previous Message Michael Paquier 2020-05-13 05:15:05 Re: Event trigger code comment duplication