Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content

Commit 3ef18a9

Browse files
committed
doc: Fix descriptions related to the handling of non-ASCII characters
Since 45b1a67, 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
1 parent 714780d commit 3ef18a9

File tree

2 files changed

+12
-9
lines changed

2 files changed

+12
-9
lines changed

doc/src/sgml/config.sgml

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6893,8 +6893,9 @@ local0.* /var/log/postgresql
68936893
and included in CSV log entries. It can also be included in regular
68946894
log entries via the <xref linkend="guc-log-line-prefix"/> parameter.
68956895
Only printable ASCII characters may be used in the
6896-
<varname>application_name</varname> value. Other characters will be
6897-
replaced with question marks (<literal>?</literal>).
6896+
<varname>application_name</varname> value.
6897+
Other characters are replaced with <link
6898+
linkend="sql-syntax-strings-escape">C-style hexadecimal escapes</link>.
68986899
</para>
68996900
</listitem>
69006901
</varlistentry>
@@ -7890,10 +7891,12 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv;
78907891
The name can be any string of less
78917892
than <symbol>NAMEDATALEN</symbol> characters (64 characters in a standard
78927893
build). Only printable ASCII characters may be used in the
7893-
<varname>cluster_name</varname> value. Other characters will be
7894-
replaced with question marks (<literal>?</literal>). No name is shown
7895-
if this parameter is set to the empty string <literal>''</literal> (which is
7896-
the default). This parameter can only be set at server start.
7894+
<varname>cluster_name</varname> value.
7895+
Other characters are replaced with <link
7896+
linkend="sql-syntax-strings-escape">C-style hexadecimal escapes</link>.
7897+
No name is shown if this parameter is set to the empty string
7898+
<literal>''</literal> (which is the default).
7899+
This parameter can only be set at server start.
78977900
</para>
78987901
</listitem>
78997902
</varlistentry>

doc/src/sgml/postgres-fdw.sgml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1067,9 +1067,9 @@ postgres=# SELECT postgres_fdw_disconnect_all();
10671067
of any length and contain even non-ASCII characters. However when
10681068
it's passed to and used as <varname>application_name</varname>
10691069
in a foreign server, note that it will be truncated to less than
1070-
<symbol>NAMEDATALEN</symbol> characters and anything other than
1071-
printable ASCII characters will be replaced with question
1072-
marks (<literal>?</literal>).
1070+
<symbol>NAMEDATALEN</symbol> characters.
1071+
Anything other than printable ASCII characters are replaced with <link
1072+
linkend="sql-syntax-strings-escape">C-style hexadecimal escapes</link>.
10731073
See <xref linkend="guc-application-name"/> for details.
10741074
</para>
10751075

0 commit comments

Comments
 (0)