Doc: clarify behavior of boolean options in replication commands.
authorTom Lane <tgl@sss.pgh.pa.us>
Mon, 30 Jan 2023 16:59:37 +0000 (11:59 -0500)
committerTom Lane <tgl@sss.pgh.pa.us>
Mon, 30 Jan 2023 16:59:37 +0000 (11:59 -0500)
commitec7e053a98f39a9e3c7e6d35f0d2e83933882399
treefcd59a8d9defc49d85c9eab4bf47abfc10928d58
parentfe9e658f4d7fbc12d2b6a74c4ee90c73e53d68ef
Doc: clarify behavior of boolean options in replication commands.

defGetBoolean() allows the "value" part of "option = value"
syntax to be omitted, in which case it's taken as "true".
This is acknowledged in our syntax summaries for relevant commands,
but we don't seem to have documented the actual behavior anywhere.
Do so for CREATE/ALTER PUBLICATION/SUBSCRIPTION.  Use generic
boilerplate text for this, with the idea that we can copy-and-paste
it into other relevant reference pages, whenever someone gets
around to that.

Peter Smith, edited a bit by me

Discussion: https://postgr.es/m/CAHut+PvwjZfdGt2R8HTXgSZft=jZKymrS8KUg31pS7zqaaWKKw@mail.gmail.com
doc/src/sgml/ref/alter_subscription.sgml
doc/src/sgml/ref/create_publication.sgml
doc/src/sgml/ref/create_subscription.sgml