Re: Corrected documentation of data type for the logical replication message formats. - Mailing list pgsql-hackers

From Euler Taveira
Subject Re: Corrected documentation of data type for the logical replication message formats.
Date
Msg-id c5e23782-bb07-4269-86fd-182b9a3c3627@www.fastmail.com
Whole thread Raw
In response to Re: Corrected documentation of data type for the logical replication message formats.  (vignesh C <vignesh21@gmail.com>)
Responses Re: Corrected documentation of data type for the logical replication message formats.
List pgsql-hackers
On Mon, May 10, 2021, at 10:45 AM, vignesh C wrote:
I agree to specifying the actual dataypes like XLogRecPtr for lsn,
TimestampTz for timestamp, TransactionId for xid and Oid for the
object id. Attached v2 patch which is changed on similar lines.
Thoughts?
Perhaps I didn't make myself clear, I didn't suggest to replace the actual
message data types [1] with the internal representation. We could probably
expand the description to include the internal representation. Hence, it is
less confusing that the actual text. Peter suggested the same in a previous
email.

Although, "Message Data Types" is one section before "Message Formats", it is
probably intuitive that the data type for each message refer to the previous
section. However, it is not so clear three section later. A sentence like

The base data types used are described in the section "Messages Data Types".

at the first paragraph could help understand what these data types refer to
(and also add a link to the data types section).


--
Euler Taveira

pgsql-hackers by date:

Previous
From: Amit Langote
Date:
Subject: update/delete and execution-time partition pruning
Next
From: Andrey Lepikhov
Date:
Subject: Defer selection of asynchronous subplans until the executor initialization stage