Re: Comment for UserMappingPasswordRequired in contrib/postgres_fdw - Mailing list pgsql-hackers

From Andreas Karlsson
Subject Re: Comment for UserMappingPasswordRequired in contrib/postgres_fdw
Date
Msg-id a81dbd27-2738-47d6-b838-9a24678a6c26@proxel.se
Whole thread Raw
In response to Re: Comment for UserMappingPasswordRequired in contrib/postgres_fdw  (Etsuro Fujita <etsuro.fujita@gmail.com>)
Responses Re: Comment for UserMappingPasswordRequired in contrib/postgres_fdw
List pgsql-hackers
On 2/22/26 12:10 PM, Etsuro Fujita wrote:
>> /*
>>    * Checks the value of password_required, defaults to true
>>    * if not defined. The mapping has been pre-validated.
>>    */
> 
> I like your wording.  I am not a native speaker either, though.  This
> would be nitpicking, but I think it is better to clearly mention what
> the function returns.  How about modifying it a bit, like this?
> 
> /*
>   * Check and return the value of password_required, if defined; otherwise,
>   * return true, which is the default value of it.  The mapping has been
>   * pre-validated.
>   */
No strong opinion. I would be fine with either. I do not think saying 
that it returns is necessary since you can see that from the function 
definition but it does not really harm either.

-- 
Andreas Karlsson
Percona




pgsql-hackers by date:

Previous
From: Yasir
Date:
Subject: Re: Regression failures after changing PostgreSQL blocksize
Next
From: "Hayato Kuroda (Fujitsu)"
Date:
Subject: RE: Improve docs syntax checking and enable it in the meson build