| From: | Peter Eisentraut <peter(at)eisentraut(dot)org> |
|---|---|
| To: | Peter Smith <smithpb2250(at)gmail(dot)com> |
| Cc: | Xiaopeng Wang <wxp_728(at)163(dot)com>, Chao Li <li(dot)evan(dot)chao(at)gmail(dot)com>, PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org> |
| Subject: | Re: Add missing period to DETAIL messages |
| Date: | 2026-07-21 13:44:12 |
| Message-ID: | aaab0d1a-cb56-482b-8523-2a4d5c7c5493@eisentraut.org |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-hackers |
On 16.04.26 02:22, Peter Smith wrote:
> On Thu, Apr 16, 2026 at 4:26 AM Peter Eisentraut <peter(at)eisentraut(dot)org> wrote:
>>
>> On 15.04.26 09:41, Peter Smith wrote:
>>> On Wed, Apr 15, 2026 at 3:48 PM Xiaopeng Wang <wxp_728(at)163(dot)com> wrote:
>>>>
>>> ...
>>>>
>>>> Looks good to me.
>>>>
>>>> A small comment is that, the commit message claims only “add missing period to DETAIL messages”, but apparently the patch also changes capitalization in many places, so the commit message should be updated.
>>>>
>>>
>>> Fair point. Thanks for your review!
>>>
>>> PSA v4 which has an improved commit message.
>>
>> Most of these look good, but I don't think this is an improvement:
>>
>> -DETAIL: syntax error at end of input
>> +DETAIL: syntax error at end of input.
>>
>> The guidelines say that the detail message should be a sentence. But
>> this is not a sentence. Just adding a period doesn't make it a
>> sentence. IMO, having a period at the end of a thing that is not a
>> sentence is worse than not having it be a sentence. The latter just
>> violates our quality standards, the former is confusing for a user who
>> sees that particular output.
>
> Thanks for your review.
>
> OK, I've removed that "syntax error at end of input." change from the patch.
>
> IIUC, the identical (non-sentence) issue also applies to other ones
> like 'syntax error at or near \"%s\".'
> So I removed those from the patch, too.
>
> PSA v5, which makes the above changes.
committed
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Robert Haas | 2026-07-21 14:04:54 | Re: Bypassing cursors in postgres_fdw to enable parallel plans |
| Previous Message | Antonin Houska | 2026-07-21 13:28:22 | Re: Unexpected behavior after OOM errors |