summaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorAndres Freund2014-08-28 11:59:29 +0000
committerAndres Freund2014-08-28 11:59:29 +0000
commit11a020eb6e4023a1570a2788ba22dd6aafbd02dc (patch)
tree9a33f530bc058929f6e823250111c238c6c1d267 /doc/src
parente23014f3d40f7d2c23bc97207fd28efbe5ba102b (diff)
Allow escaping of option values for options passed at connection start.
This is useful to allow to set GUCs to values that include spaces; something that wasn't previously possible. The primary case motivating this is the desire to set default_transaction_isolation to 'repeatable read' on a per connection basis, but other usecases like seach_path do also exist. This introduces a slight backward incompatibility: Previously a \ in an option value would have been passed on literally, now it'll be taken as an escape. The relevant mailing list discussion starts with [email protected].
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/protocol.sgml5
1 files changed, 4 insertions, 1 deletions
diff --git a/doc/src/sgml/protocol.sgml b/doc/src/sgml/protocol.sgml
index e519ff96b90..a8a09e4f0ec 100644
--- a/doc/src/sgml/protocol.sgml
+++ b/doc/src/sgml/protocol.sgml
@@ -4734,7 +4734,10 @@ StartupMessage (F)
set at backend start time might be listed. Such settings
will be applied during backend start (after parsing the
command-line options if any). The values will act as
- session defaults.
+ session defaults. Spaces in option values need to be escaped
+ with a backslash (<literal>\</>). A literal backslash can be
+ passed by escaping it with another backslash
+ (i.e <literal>\\</>).
</para>
</listitem>
</varlistentry>