Improve PQauthDataHook_type docs

From: Daniele Varrazzo <daniele(dot)varrazzo(at)gmail(dot)com>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Improve PQauthDataHook_type docs
Date: 2026-04-19 15:54:02
Message-ID: CA+mi_8aEyKfLG3_+x7uU6HBYtOug3HYFRq1sz7JB7N89=EmKUA@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Hello,

In https://www.postgresql.org/docs/18/libpq-oauth.html#LIBPQ-OAUTH-AUTHDATA-HOOKS
it is not entirely clear that `hook_fn` is the definition of the
`PQauthDataHook_type` used in the functions signature, because the
name is not used elsewhere. The function signatures refer to the
typedef but the typedef is not shown.

Using https://www.postgresql.org/docs/18/libpq-notice-processing.html#LIBPQ-NOTICE-PROCESSING
as a guideline I suggest to show the typedef of the callback rather
than the `hook_fn` example, so that the `PQauthDataHook_type` name can
be searched for.

Please check the patch attached.

Cheers

-- Daniele

Attachment Content-Type Size
0001-doc-improve-PQauthDataHook_type-definition.patch text/x-patch 1.1 KB

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Fujii Masao 2026-04-20 10:02:52 Two small doc fixes for config.sgml
Previous Message Víctor Herraiz Posada 2026-04-18 13:40:22 Re: Temporary tables and Write-Ahead Log