fix deprecation mention for age() and mxid_age()

From: Bertrand Drouvot <bertranddrouvot(dot)pg(at)gmail(dot)com>
To: pgsql-hackers(at)lists(dot)postgresql(dot)org
Subject: fix deprecation mention for age() and mxid_age()
Date: 2024-11-18 08:11:57
Message-ID: Zzr2zZFyeFKXWe8a@ip-10-97-1-34.eu-west-3.compute.internal
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Hi hackers,

48b5aa3143 mentioned age() and mxid_age() as deprecated. As per the discussion in
[1], it looks like that was not intentional.

Please find attached a patch to fix this on master and its version for the 17
stable branch backpatch. I think that's worth a backpatch as that could raise
concerns to read that the functions you rely on for monitoring are deprecated
and could generate questions like "will they be removed in PG 18?", "if so, what
is the supported/recommended way to calculate age of transaction id’s?".

Also it looks like that for PG 16, 7471230cc6, did put the functions description
in the "Control Data Functions". That looks unintentional too, so moving it to
"Transaction ID and Snapshot Information Functions" section instead.

Please find attached the 3 patches.

[1]: https://www.postgresql.org/message-id/20231114013224.4z6oxa6p6va33rxr%40awork3.anarazel.de

Looking forward to your feedback,

Regards,

--
Bertrand Drouvot
PostgreSQL Contributors Team
RDS Open Source Databases
Amazon Web Services: https://aws.amazon.com

Attachment Content-Type Size
master_v1-0001-fix-deprecation-mention-for-age-and-mxid_age.patch text/x-diff 3.5 KB
17stable_v1-0001-fix-deprecation-mention-for-age-and-mxid_age.patch text/x-diff 3.5 KB
16stable_v1-0001-fix-doc-location-for-age-and-mxid_age.patch text/x-diff 3.5 KB

Browse pgsql-hackers by date

  From Date Subject
Next Message Emanuele Musella 2024-11-18 09:01:41 Re: Parametrization minimum password lenght
Previous Message Amit Kapila 2024-11-18 08:01:45 Re: DOCS - pg_replication_slot . Fix the 'inactive_since' description