Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content

Commit 87cf7b6

Browse files
committed
doc: improve ALTER SYSTEM description of value list quoting
Reported-by: splarv@ya.ru Discussion: https://postgr.es/m/167105927893.1897.13227723035830709578@wrigleys.postgresql.org Backpatch-through: 11
1 parent b69db51 commit 87cf7b6

File tree

1 file changed

+9
-1
lines changed

1 file changed

+9
-1
lines changed

doc/src/sgml/ref/alter_system.sgml

+9-1
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ PostgreSQL documentation
2121

2222
<refsynopsisdiv>
2323
<synopsis>
24-
ALTER SYSTEM SET <replaceable class="parameter">configuration_parameter</replaceable> { TO | = } { <replaceable class="parameter">value</replaceable> | '<replaceable class="parameter">value</replaceable>' | DEFAULT }
24+
ALTER SYSTEM SET <replaceable class="parameter">configuration_parameter</replaceable> { TO | = } { <replaceable class="parameter">value</replaceable> [, ...] | DEFAULT }
2525

2626
ALTER SYSTEM RESET <replaceable class="parameter">configuration_parameter</replaceable>
2727
ALTER SYSTEM RESET ALL
@@ -83,9 +83,17 @@ ALTER SYSTEM RESET ALL
8383
New value of the parameter. Values can be specified as string
8484
constants, identifiers, numbers, or comma-separated lists of
8585
these, as appropriate for the particular parameter.
86+
Values that are neither numbers nor valid identifiers must be quoted.
8687
<literal>DEFAULT</literal> can be written to specify removing the
8788
parameter and its value from <filename>postgresql.auto.conf</filename>.
8889
</para>
90+
91+
<para>
92+
For some list-accepting parameters, quoted values will produce
93+
double-quoted output to preserve whitespace and commas; for others,
94+
double-quotes must be used inside single-quoted strings to get
95+
this effect.
96+
</para>
8997
</listitem>
9098
</varlistentry>
9199
</variablelist>

0 commit comments

Comments
 (0)