diff --git a/doc/src/sgml/ref/pg_receivewal.sgml b/doc/src/sgml/ref/pg_receivewal.sgml
index cf9c41d54b0..eac9bd27838 100644
--- a/doc/src/sgml/ref/pg_receivewal.sgml
+++ b/doc/src/sgml/ref/pg_receivewal.sgml
@@ -75,6 +75,29 @@ PostgreSQL documentation
one session available for the stream.
+
+ The starting point of the write-ahead log streaming is calculated when
+ pg_receivewal starts:
+
+
+
+ First, scan the directory where the WAL segment files are written and
+ find the newest completed segment file, using as starting point the
+ beginning of the next WAL segment file. This is calculated independently
+ on the compression method used to compress each segment.
+
+
+
+
+
+ If a starting point cannot be calculated with the previous method,
+ the latest WAL flush location is used as reported by the server from
+ a IDENTIFY_SYSTEM command.
+
+
+
+
+
If the connection is lost, or if it cannot be initially established,
with a non-fatal error, pg_receivewal will