From c8bcddf22c02422c5a678f70f2120cf56d0022bc Mon Sep 17 00:00:00 2001
From: Anthonin Bonnefoy <anthonin.bonnefoy@datadoghq.com>
Date: Mon, 23 Jun 2025 09:16:13 +0200
Subject: Doc: improve documentation on stream abort

Protocol v4 introduces parallel streaming. With this change, Stream
Abort messages will have additional abort info when parallel streaming
is enabled. However, the doc only mentions "This field is available
since protocol version 4", which can be confused as they will be
present as long as it's using protocol version 4.

This patch adds precision that abort LSN and TS are only present if
parallel stream is used.
---
 doc/src/sgml/protocol.sgml | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/doc/src/sgml/protocol.sgml b/doc/src/sgml/protocol.sgml
index 137ffc8d0b7..b4b916496a7 100644
--- a/doc/src/sgml/protocol.sgml
+++ b/doc/src/sgml/protocol.sgml
@@ -7292,23 +7292,23 @@ psql "dbname=postgres replication=database" -c "IDENTIFY_SYSTEM;"
        <term>Int64 (XLogRecPtr)</term>
        <listitem>
         <para>
-         The LSN of the abort. This field is available since protocol version
-         4.
-        </para>
-       </listitem>
-      </varlistentry>
-
-      <varlistentry>
-       <term>Int64 (TimestampTz)</term>
-       <listitem>
-        <para>
-         Abort timestamp of the transaction. The value is in number
-         of microseconds since PostgreSQL epoch (2000-01-01). This field is
+         The LSN of the abort (only present for parallel stream). This field is
          available since protocol version 4.
         </para>
        </listitem>
       </varlistentry>
 
+      <varlistentry>
+       <term>Int64 (TimestampTz)</term>
+       <listitem>
+        <para>
+         Abort timestamp of the transaction (only present for parallel stream).
+         The value is in number of microseconds since PostgreSQL epoch (2000-01-01).
+         This field is available since protocol version 4.
+        </para>
+       </listitem>
+      </varlistentry>
+
      </variablelist>
     </listitem>
    </varlistentry>
-- 
2.49.0

