diff --git a/doc/appendix-faq.sgml b/doc/appendix-faq.sgml index 0760cdb8..d4d63c82 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. + +