From 7bcf87b8eda2600d2da4ddd68fd714515cb93b32 Mon Sep 17 00:00:00 2001 From: Ian Barwick Date: Wed, 15 Aug 2018 14:42:56 +0900 Subject: [PATCH] doc: update FAQ Explain why some values in recovery.conf are surrounded by pairs of single quotes. --- doc/appendix-faq.sgml | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/doc/appendix-faq.sgml b/doc/appendix-faq.sgml index 5783153e..d3ced69c 100644 --- a/doc/appendix-faq.sgml +++ b/doc/appendix-faq.sgml @@ -239,11 +239,22 @@ Under some circumstances event notifications can be generated for servers which have not yet been registered; it's also useful to retain a record of events which includes servers removed from the replication cluster - which no longer have an entry in the repmrg.nodes table. + which no longer have an entry in the repmgr.nodes table. - + + Why are some values in <filename>recovery.conf</filename> surrounded by pairs of single quotes? + + This is to ensure that user-supplied values which are written as parameter values in recovery.conf + are escaped correctly and do not cause errors when recovery.conf is parsed. + + + The escaping is performed by an internal PostgreSQL routine, which leaves strings consisting + of digits and alphabetical characters only as-is, but wraps everything else in pairs of single quotes, + even if the string does not contain any characters which need escaping. + +