Re: Comment for UserMappingPasswordRequired in contrib/postgres_fdw

From: Etsuro Fujita <etsuro(dot)fujita(at)gmail(dot)com>
To: Andreas Karlsson <andreas(at)proxel(dot)se>
Cc: PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: Comment for UserMappingPasswordRequired in contrib/postgres_fdw
Date: 2026-02-23 09:36:38
Message-ID: CAPmGK150xxVYeho6w=UyxhJs8bPo-hwD6XcGuLOJDs64PMO3zQ@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Mon, Feb 23, 2026 at 8:01 AM Andreas Karlsson <andreas(at)proxel(dot)se> wrote:
> 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.

Ok. I like the modified version as it also keeps the existing comment
to some extent, so I'd like to go with it. Updated patch attached. I
will push and back-patch it to all supported versions if there are no
objections from others.

Thanks!

Best regards,
Etsuro Fujita

Attachment Content-Type Size
comment-fix-2.patch application/octet-stream 650 bytes

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message John Naylor 2026-02-23 09:40:28 Re: [PATCH] Refactor *_abbrev_convert() functions
Previous Message David Geier 2026-02-23 09:21:00 Re: Hash-based MCV matching for large IN-lists