From e29db615b0f1056b9de9aa748e6881381959026f Mon Sep 17 00:00:00 2001
From: Shihao <zhong950419@gmail.com>
Date: Sun, 20 Sep 2026 15:20:20 -0400
Subject: [PATCH v1] doc: fix format() example output for a value with a
 backslash

The example says that format('INSERT INTO %I VALUES(%L)', 'locations',
'C:\Program Files') returns INSERT INTO locations VALUES('C:\Program Files').
A backslash makes quote_literal emit an escape string constant, so the real
output is INSERT INTO locations VALUES(E'C:\\Program Files').

Reported-by: Yury Saburov <y.saburov@gmail.com>
Discussion: https://postgr.es/m/178979714249.1241.1230833804069549466%40wrigleys.postgresql.org
Backpatch-through: 14
---
 doc/src/sgml/func.sgml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index d065b8be1e1..9a15fe73a4d 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -4198,7 +4198,7 @@ SELECT format('INSERT INTO %I VALUES(%L)', 'Foo bar', E'O\'Reilly');
 <lineannotation>Result: </lineannotation><computeroutput>INSERT INTO "Foo bar" VALUES('O''Reilly')</computeroutput>
 
 SELECT format('INSERT INTO %I VALUES(%L)', 'locations', 'C:\Program Files');
-<lineannotation>Result: </lineannotation><computeroutput>INSERT INTO locations VALUES('C:\Program Files')</computeroutput>
+<lineannotation>Result: </lineannotation><computeroutput>INSERT INTO locations VALUES(E'C:\\Program Files')</computeroutput>
 </screen>
     </para>
 
-- 
2.37.1 (Apple Git-137.1)

