Re: Add missing period to DETAIL messages - Mailing list pgsql-hackers

From Peter Eisentraut
Subject Re: Add missing period to DETAIL messages
Date
Msg-id e297aa41-0e81-43b1-9e43-a157df99f186@eisentraut.org
Whole thread
In response to Re: Add missing period to DETAIL messages  (Peter Smith <smithpb2250@gmail.com>)
Responses Re: Add missing period to DETAIL messages
List pgsql-hackers
On 15.04.26 09:41, Peter Smith wrote:
> On Wed, Apr 15, 2026 at 3:48 PM Xiaopeng Wang <wxp_728@163.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
patchalso 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.




pgsql-hackers by date:

Previous
From: Tom Lane
Date:
Subject: Re: Do we still need gen_node_support.pl's nodetag ABI stability check?
Next
From: Antonin Houska
Date:
Subject: Re: Adding REPACK [concurrently]