Hello, While reading the *“Server Configuration”* documentation, I noticed a potentially misleading statement in:
https://www.postgresql.org/docs/current/runtime-config.html (Chapter 19 → 19.1.2 “Parameter Interaction via the Configuration File”) The text says that when the postmaster receives SIGHUP/reload, it propagates the signal to all server processes “so that existing sessions also adopt the new values”. As written, this can be interpreted to mean that any changed parameter in postgresql.conf will be adopted by already-connected sessions after a reload. However, many GUCs have context “backend” or “superuser-backend” and do not change within an already-started session; those changes only affect subsequently-launched sessions. *Suggestion*: qualify the sentence to indicate that existing sessions will pick up changes only for parameters whose context allows it (e.g., “sighup”), and that “backend” / “superuser-backend” settings won’t change for existing sessions. *Proposed wording (illustrative diff):* *"* *- The main server process also propagates this signal to all currently running server processes,* *- so that existing sessions also adopt the new values (this will happen after they complete any- currently-executing client command).* *+ The main server process also propagates this signal to all currently running server processes.+ Existing sessions will adopt new values for parameters whose context allows changes at reload+ time (for example, sighup). Parameters whose context is backend or superuser-backend do not+ change within an already-started session; changes to those only affect subsequently-launched+ sessions.* " Happy to send a formal patch if you would like. Thanks, Balkrishna
