Doc: improve protocol spec for logical replication Type messages.
authorTom Lane <tgl@sss.pgh.pa.us>
Wed, 10 Nov 2021 18:12:58 +0000 (13:12 -0500)
committerTom Lane <tgl@sss.pgh.pa.us>
Wed, 10 Nov 2021 18:13:04 +0000 (13:13 -0500)
commitc3b33698cf88550b017620f73b94b53029897f39
treea8a3d22931fa960cf84c20d6718a48c3a2c4f1f0
parent10eae82b27cebbb9586cda8baf8e3226496891d0
Doc: improve protocol spec for logical replication Type messages.

protocol.sgml documented the layout for Type messages, but completely
dropped the ball otherwise, failing to explain what they are, when
they are sent, or what they're good for.  While at it, do a little
copy-editing on the description of Relation messages.

In passing, adjust the comment for apply_handle_type() to make it
clearer that we choose not to do anything when receiving a Type
message, not that we think it has no use whatsoever.

Per question from Stefen Hillman.

Discussion: http://postgr.es/m/CAPgW8pMknK5pup6=T4a_UG=Cz80Rgp=KONqJmTdHfaZb0RvnFg@mail.gmail.com
doc/src/sgml/protocol.sgml
src/backend/replication/logical/worker.c