rdelaage
/
postgresql
mirror of https://git.postgresql.org/git/postgresql.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

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

Since 45b1a67a0f, 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
This commit is contained in:
Michael Paquier 2023-09-29 10:34:04 +09:00
parent 714780dcdd
commit 3ef18a90bd
2 changed files with 12 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
doc/src/sgml/config.sgml
View File

@ -6893,8 +6893,9 @@ local0.* /var/log/postgresql
and included in CSV log entries. It can also be included in regular
log entries via the <xref linkend="guc-log-line-prefix"/> parameter.
Only printable ASCII characters may be used in the
<varname>application_name</varname> value. Other characters will be
replaced with question marks (<literal>?</literal>).
<varname>application_name</varname> value.
Other characters are replaced with <link
linkend="sql-syntax-strings-escape">C-style hexadecimal escapes</link>.
</para>
</listitem>
</varlistentry>
@ -7890,10 +7891,12 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv;
The name can be any string of less
than <symbol>NAMEDATALEN</symbol> characters (64 characters in a standard
build). Only printable ASCII characters may be used in the
<varname>cluster_name</varname> value. Other characters will be
replaced with question marks (<literal>?</literal>). No name is shown
if this parameter is set to the empty string <literal>''</literal> (which is
the default). This parameter can only be set at server start.
<varname>cluster_name</varname> value.
Other characters are replaced with <link
linkend="sql-syntax-strings-escape">C-style hexadecimal escapes</link>.
No name is shown if this parameter is set to the empty string
<literal>''</literal> (which is the default).
This parameter can only be set at server start.
</para>
</listitem>
</varlistentry>

6
doc/src/sgml/postgres-fdw.sgml
View File

@ -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 <varname>application_name</varname>
in a foreign server, note that it will be truncated to less than
<symbol>NAMEDATALEN</symbol> characters and anything other than
printable ASCII characters will be replaced with question
marks (<literal>?</literal>).
<symbol>NAMEDATALEN</symbol> characters.
Anything other than printable ASCII characters are replaced with <link
linkend="sql-syntax-strings-escape">C-style hexadecimal escapes</link>.
See <xref linkend="guc-application-name"/> for details.
</para>