aboutsummaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/sources.sgml25
1 files changed, 18 insertions, 7 deletions
diff --git a/doc/src/sgml/sources.sgml b/doc/src/sgml/sources.sgml
index ac8f462de0e..4ed83d6189b 100644
--- a/doc/src/sgml/sources.sgml
+++ b/doc/src/sgml/sources.sgml
@@ -214,13 +214,12 @@ ereport(ERROR,
</listitem>
<listitem>
<para>
- <function>errdetail_log(const char *msg, ...)</function> is the same as
- <function>errdetail</> except that this string goes only to the server
- log, never to the client. If both <function>errdetail</> and
- <function>errdetail_log</> are used then one string goes to the client
- and the other to the log. This is useful for error details that are
- too security-sensitive or too bulky to include in the report
- sent to the client.
+ <function>errdetail_internal(const char *msg, ...)</function> is the same
+ as <function>errdetail</>, except that the message string will not be
+ translated nor included in the internationalization message dictionary.
+ This should be used for detail messages that are not worth expending
+ translation effort on, for instance because they are too technical to be
+ useful to most users.
</para>
</listitem>
<listitem>
@@ -233,6 +232,18 @@ ereport(ERROR,
</listitem>
<listitem>
<para>
+ <function>errdetail_log(const char *msg, ...)</function> is the same as
+ <function>errdetail</> except that this string goes only to the server
+ log, never to the client. If both <function>errdetail</> (or one of
+ its equivalents above) and
+ <function>errdetail_log</> are used then one string goes to the client
+ and the other to the log. This is useful for error details that are
+ too security-sensitive or too bulky to include in the report
+ sent to the client.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
<function>errhint(const char *msg, ...)</function> supplies an optional
<quote>hint</> message; this is to be used when offering suggestions
about how to fix the problem, as opposed to factual details about