Document XLOG_INCLUDE_XID a little better
authorAlvaro Herrera <alvherre@alvh.no-ip.org>
Tue, 21 Sep 2021 22:47:53 +0000 (19:47 -0300)
committerAlvaro Herrera <alvherre@alvh.no-ip.org>
Tue, 21 Sep 2021 22:47:53 +0000 (19:47 -0300)
commitade24dab97a20dae74fb57c0106dfe0e0303541b
treecd65f1b39138e8ee65cd7712c7402865eac42c58
parent43c1c4f65eab77bcfc4f535a7e9ac0421e0cf2a5
Document XLOG_INCLUDE_XID a little better

I noticed that commit 0bead9af484c left this flag undocumented in
XLogSetRecordFlags, which led me to discover that the flag doesn't
actually do what the one comment on it said it does.  Improve the
situation by adding some more comments.

Backpatch to 14, where the aforementioned commit appears.

Author: Álvaro Herrera <alvherre@alvh.no-ip.org>
Discussion: https://postgr.es/m/202109212119.c3nhfp64t2ql@alvherre.pgsql
src/backend/access/transam/xloginsert.c
src/include/access/xlog.h
src/include/access/xlogrecord.h