Re: pub/sub - specifying optional parameters without values. - Mailing list pgsql-hackers

From Justin Pryzby
Subject Re: pub/sub - specifying optional parameters without values.
Date
Msg-id 20221017200921.GW7745@telsasoft.com
Whole thread Raw
In response to pub/sub - specifying optional parameters without values.  (Peter Smith <smithpb2250@gmail.com>)
Responses Re: pub/sub - specifying optional parameters without values.  (Peter Smith <smithpb2250@gmail.com>)
List pgsql-hackers
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



pgsql-hackers by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: Warning about using pg_stat_reset() and pg_stat_reset_shared()
Next
From: Andres Freund
Date:
Subject: Re: hash_xlog_split_allocate_page: failed to acquire cleanup lock