Define MXID acronym in documentation

Started by Koshino Taiki4 days ago3 messageshackers
Jump to latest
#1Koshino Taiki
koshino@sraoss.co.jp

Hi,

I noticed that while XID (Transaction ID) is properly defined as an
acronym in the PostgreSQL documentation, MXID (Multixact ID) is used
without a formal definition.

This patch adds an entry for MXID to acronyms.sgml with a link to the
"Multixacts and Wraparound" section, and introduces the acronym in
maintenance.sgml alongside the existing "Multixact IDs" term, following
the same pattern used for XID.

Regards,
Taiki Koshino

Taiki Koshino<koshino@sraoss.co.jp>
SRA OSS K.K.
TEL: 03-5979-2701 FAX: 03-5979-2702
URL: https://www.sraoss.co.jp/

Attachments:

v1-0001-doc-Define-MXID-acronym-and-link-it-to-multixact-.patchapplication/octet-stream; name=v1-0001-doc-Define-MXID-acronym-and-link-it-to-multixact-.patchDownload+10-2
#2Daniel Gustafsson
daniel@yesql.se
In reply to: Koshino Taiki (#1)
Re: Define MXID acronym in documentation

On 5 Aug 2026, at 07:17, Koshino Taiki <koshino@sraoss.co.jp> wrote:

Hi,

I noticed that while XID (Transaction ID) is properly defined as an
acronym in the PostgreSQL documentation, MXID (Multixact ID) is used
without a formal definition.

This patch adds an entry for MXID to acronyms.sgml with a link to the
"Multixacts and Wraparound" section, and introduces the acronym in
maintenance.sgml alongside the existing "Multixact IDs" term, following
the same pattern used for XID.

Good find, pushed. Thanks for your contribution!

--
Daniel Gustafsson

#3Koshino Taiki
koshino@sraoss.co.jp
In reply to: Daniel Gustafsson (#2)
Re: Define MXID acronym in documentation

Thank you for pushing this.

Let me suggest one more small fix.

Since the preceding word is plural, the acronym should probably be
pluralized too: (<acronym>MXID</acronym>s) rather than
(<acronym>MXID</acronym>).

This matches existing conventions elsewhere in the docs, e.g. MCVs
(most common values) and MCFs (most common frequencies) in
planstats.sgml.

Taiki Koshino<koshino@sraoss.co.jp>
SRA OSS K.K.
TEL: 03-5979-2701 FAX: 03-5979-2702
URL: https://www.sraoss.co.jp/

________________________________
差出人: Daniel Gustafsson <daniel@yesql.se>
送信日時: 2026年8月6日 21:12
宛先: Koshino Taiki <koshino@sraoss.co.jp>
CC: pgsql-hackers@lists.postgresql.org <pgsql-hackers@lists.postgresql.org>
件名: Re: Define MXID acronym in documentation

On 5 Aug 2026, at 07:17, Koshino Taiki <koshino@sraoss.co.jp> wrote:

Hi,

I noticed that while XID (Transaction ID) is properly defined as an
acronym in the PostgreSQL documentation, MXID (Multixact ID) is used
without a formal definition.

This patch adds an entry for MXID to acronyms.sgml with a link to the
"Multixacts and Wraparound" section, and introduces the acronym in
maintenance.sgml alongside the existing "Multixact IDs" term, following
the same pattern used for XID.

Good find, pushed. Thanks for your contribution!

--
Daniel Gustafsson

Attachments:

v2-0001-Fix-pluralization-of-MXID-acronym-in-documentatio.patchapplication/octet-stream; name=v2-0001-Fix-pluralization-of-MXID-acronym-in-documentatio.patchDownload+1-2