sharpetronics/PostgreSQL
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-05-20 00:03:14 -04:00
Code Issues Projects Releases Wiki Activity

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

Browse Source 
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
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 and included in CSV log entries. It can also be included in regular
log entries via the <xref linkend="guc-log-line-prefix"/> parameter. log entries via the <xref linkend="guc-log-line-prefix"/> parameter.
Only printable ASCII characters may be used in the Only printable ASCII characters may be used in the
<varname>application_name</varname> value. Other characters will be <varname>application_name</varname> value.
replaced with question marks (<literal>?</literal>). Other characters are replaced with <link
linkend="sql-syntax-strings-escape">C-style hexadecimal escapes</link>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -7890,10 +7891,12 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv;
The name can be any string of less The name can be any string of less
than <symbol>NAMEDATALEN</symbol> characters (64 characters in a standard than <symbol>NAMEDATALEN</symbol> characters (64 characters in a standard
build). Only printable ASCII characters may be used in the build). Only printable ASCII characters may be used in the
<varname>cluster_name</varname> value. Other characters will be <varname>cluster_name</varname> value.
replaced with question marks (<literal>?</literal>). No name is shown Other characters are replaced with <link
if this parameter is set to the empty string <literal>''</literal> (which is linkend="sql-syntax-strings-escape">C-style hexadecimal escapes</link>.
the default). This parameter can only be set at server start. 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> </para>
</listitem> </listitem>
</varlistentry> </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 of any length and contain even non-ASCII characters. However when
it's passed to and used as <varname>application_name</varname> it's passed to and used as <varname>application_name</varname>
in a foreign server, note that it will be truncated to less than in a foreign server, note that it will be truncated to less than
<symbol>NAMEDATALEN</symbol> characters and anything other than <symbol>NAMEDATALEN</symbol> characters.
printable ASCII characters will be replaced with question Anything other than printable ASCII characters are replaced with <link
marks (<literal>?</literal>). linkend="sql-syntax-strings-escape">C-style hexadecimal escapes</link>.
See <xref linkend="guc-application-name"/> for details. See <xref linkend="guc-application-name"/> for details.
</para> </para>