On Fri, Oct 14, 2022 at 07:54:37PM +1100, Peter Smith wrote:
> Hi hackers.
>
> This post is about parameter default values. Specifically. it's about
> the CREATE PUBLICATION and CREATE SUBSCRIPTION syntax, although the
> same issue might apply to other commands I am unaware of...
The same thing seems to be true in various other pages:
git grep 'WITH.*value' doc
In addition to WITH, it's also true of SET:
git grep -F '[= <replaceable class="parameter">value' doc/src/sgml/ref/alter_index.sgml
doc/src/sgml/ref/alter_table.sgmldoc/src/sgml/ref/create_materialized_view.sgml
doc/src/sgml/ref/create_publication.sgmldoc/src/sgml/ref/create_subscription.sgml
Note that some utility statements (analyze,cluster,vacuum,reindex) which
have parenthesized syntax with booleans say this:
| The boolean value can also be omitted, in which case TRUE is assumed.
BTW, in your patch:
+ <para>
+ A <type>boolean</type> parameter can omit the value. This is equivalent
+ to assigning the parameter to <literal>true</literal>.
+ </para>
+ <para>
should say: "The value can be omitted, which is equivalent to specifying
TRUE".
--
Justin