doc: Fix descriptions related to the handling of non-ASCII characters

Since 45b1a67a0fcb, non-printable ASCII characters do not show up in
various configuration paths as question marks, but as hexadecimal
escapes.  The documentation was not updated to reflect that.

Author: Hayato Kuroda
Reviewed-by: Jian He, Tom Lane, Karl O. Pinc, Peter Smith
Discussion: https://postgr.es/m/TYAPR01MB586631D0961BF9C44893FAB1F523A@TYAPR01MB5866.jpnprd01.prod.outlook.com
Backpatch-through: 16

diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index 4647539e403495cdcbd9e4e351c3ff4faccbdebe..126c147fc62589d46088745ce49e3ee1a76eadc7 100644 (file)
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -7012,8 +7012,9 @@ local0.*    /var/log/postgresql
         and included in CSV log entries.  It can also be included in regular
         log entries via the  parameter.
         Only printable ASCII characters may be used in the
-        application_name value. Other characters will be
-        replaced with question marks (?).
+        application_name value.
+        Other characters are replaced with 
+        linkend="sql-syntax-strings-escape">C-style hexadecimal escapes.
        
       
      
@@ -8009,10 +8010,12 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv;
         The name can be any string of less
         than NAMEDATALEN characters (64 characters in a standard
         build). Only printable ASCII characters may be used in the
-        cluster_name value. Other characters will be
-        replaced with question marks (?).  No name is shown
-        if this parameter is set to the empty string '' (which is
-        the default). This parameter can only be set at server start.
+        cluster_name value.
+        Other characters are replaced with 
+        linkend="sql-syntax-strings-escape">C-style hexadecimal escapes.
+        No name is shown if this parameter is set to the empty string
+        '' (which is the default).
+        This parameter can only be set at server start.
        
       
      


diff --git a/doc/src/sgml/postgres-fdw.sgml b/doc/src/sgml/postgres-fdw.sgml

index 5062d712e74c5bb56804f2d789a6c6a3bea6e5b0..c177fd41bcb1146b4d972245a9ddcfc03aa71bd6 100644 (file)

--- a/doc/src/sgml/postgres-fdw.sgml
+++ b/doc/src/sgml/postgres-fdw.sgml
@@ -1067,9 +1067,9 @@ postgres=# SELECT postgres_fdw_disconnect_all();
       of any length and contain even non-ASCII characters.  However when
       it's passed to and used as application_name
       in a foreign server, note that it will be truncated to less than
-      NAMEDATALEN characters and anything other than
-      printable ASCII characters will be replaced with question
-      marks (?).
+      NAMEDATALEN characters.
+      Anything other than printable ASCII characters are replaced with 
+      linkend="sql-syntax-strings-escape">C-style hexadecimal escapes.
       See  for details.
      
 




This is the main PostgreSQL git repository.
RSS
Atom

diff --git a/doc/src/sgml/postgres-fdw.sgml b/doc/src/sgml/postgres-fdw.sgml
index 5062d712e74c5bb56804f2d789a6c6a3bea6e5b0..c177fd41bcb1146b4d972245a9ddcfc03aa71bd6 100644 (file)
--- a/doc/src/sgml/postgres-fdw.sgml
+++ b/doc/src/sgml/postgres-fdw.sgml
@@ -1067,9 +1067,9 @@ postgres=# SELECT postgres_fdw_disconnect_all();
       of any length and contain even non-ASCII characters.  However when
       it's passed to and used as application_name
       in a foreign server, note that it will be truncated to less than
-      NAMEDATALEN characters and anything other than
-      printable ASCII characters will be replaced with question
-      marks (?).
+      NAMEDATALEN characters.
+      Anything other than printable ASCII characters are replaced with 
+      linkend="sql-syntax-strings-escape">C-style hexadecimal escapes.
       See  for details.