Define MXID acronym in documentation

Started by Koshino Taiki19 days ago4 messageshackers
Beta feature

Hackorum builds and tests every patch posted to the lists, not only commitfest submissions. This is Hackorum's own CI rather than the PostgreSQL project's, and it is still under testing - please report anything that looks wrong.

appliessuccessCI history

You can run a PostgreSQL built from this patch straight from Docker, with no checkout and no build:

docker run --rm -p 5432:5432 ghcr.io/hackorum-dev/postgres-patch:t253317
psql -h localhost -U postgres

Built from patchset v3 (message #3), August 23, 2026 at 01:54 PM.

Every patchset is also pushed to a branch of our PostgreSQL fork, so you can check out the same tree CI built. Without a PostgreSQL checkout:

git clone --branch t253317_3 https://github.com/hackorum-dev/postgres.git

In a checkout you already have, add the fork once:

git remote add hackorum https://github.com/hackorum-dev/postgres.git

then, for this patchset and every later one:

git fetch hackorum t253317_3 && git checkout t253317_3

Patchset v3 (message #3) is on t253317_3

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:

t253317_1
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:

t253317_3
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
#4Pierre Forstmann
pierre.forstmann@gmail.com
In reply to: Koshino Taiki (#3)
Re: Define MXID acronym in documentation

The following review has been posted through the commitfest application:
make installcheck-world: not tested
Implements feature: not tested
Spec compliant: not tested
Documentation: tested, passed

Hello,

LGTM.

As this is only a documentation change I have just rebuild PG 20devel and rebuild documentation with:

cd doc/src/sgml
make STYLE=webiste html

And I have checked that MXIDs is defined in following section:

"
24.1.5.1. Multixacts and Wraparound

Multixact IDs (MXIDs) are used to support row locking by multiple transactions.

"

Regards
Pierre Forstmann