Re: Please clarify docs on user-defined settings for SET and RESET - Mailing list pgsql-docs

From David G. Johnston
Subject Re: Please clarify docs on user-defined settings for SET and RESET
Date
Msg-id CAKFQuwa2FOM+W_UM6+ZbCPuKwqe832YZ6BgeU2pobv3Sw0hACQ@mail.gmail.com
Whole thread Raw
In response to Please clarify docs on user-defined settings for SET and RESET  (PG Doc comments form <noreply@postgresql.org>)
List pgsql-docs
On Monday, April 21, 2025, PG Doc comments form <noreply@postgresql.org> wrote:

It seems that the assumed/implied default value for settings that did not
exist for a session is the empty string? It would be useful to document that
behavior explicitly.

This is presently being worked on.  Some changes have made it into the v18 docs already.
 

Furthermore, it seems impossible to actually *remove* such a user defined
settings completely, correct? That too, I miss stated explicitly in the
documentation.

Correct.  The null is not the value of the setting, it is being provided instead of producing a “setting does not exist” error.

The system never forgets a setting once set (within a session).  Reset restores a setting to its default value, which for text is the empty string.

David J.

pgsql-docs by date:

Previous
From: PG Doc comments form
Date:
Subject: Please clarify docs on user-defined settings for SET and RESET
Next
From: Fujii Masao
Date:
Subject: Remove unnecessary secondary index terms for replication settings