diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 6b327d4fd81..f5a0e0954a1 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -11247,10 +11247,10 @@ now()
statement (more specifically, the time of receipt of the latest command
message from the client).
statement_timestamp() and transaction_timestamp()
- return the same value during the first command of a transaction, but might
- differ during subsequent commands.
+ return the same value during the first statement of a transaction, but might
+ differ during subsequent statements.
clock_timestamp() returns the actual current time, and
- therefore its value changes even within a single SQL command.
+ therefore its value changes even within a single SQL statement.
timeofday() is a historical
PostgreSQL function. Like
clock_timestamp(), it returns the actual current time,
diff --git a/doc/src/sgml/protocol.sgml b/doc/src/sgml/protocol.sgml
index 4cfd9767f7c..1b38e5d725a 100644
--- a/doc/src/sgml/protocol.sgml
+++ b/doc/src/sgml/protocol.sgml
@@ -886,6 +886,16 @@ SELCT 1/0;
Errors detected at semantic analysis or later, such as a misspelled
table or column name, do not have this effect.
+
+
+ Lastly, note that all the statements within the Query message will
+ observe the same value of statement_timestamp(),
+ since that timestamp is updated only upon receipt of the Query
+ message. This will result in them all observing the same
+ value of transaction_timestamp() as well,
+ except in cases where the query string ends a previously-started
+ transaction and begins a new one.
+