Documentation incorrect pg_partition_root function description.

On Sat, 2026-02-28 at 08:36 +0000, PG Doc comments form wrote:

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/18/functions-admin.html
Description:

https://www.postgresql.org/docs/current/functions-admin.html

pg_partition_root ( regclass ) → regclass
Returns the top-most parent of the partition tree to which the given
relation belongs. Returns NULL if the relation does not exist or is not a
partition or partitioned table.

"does not exist" is not correct description, if table does not exist, we'll
get an error, not NULL:

EXAMPLE:
SELECT * FROM pg_partition_root( 'nonexisting_table' );

RESULT:
SQL Error [42P01]: ERROR: relation "nonexisting_table" does not exist
Position: 34

The error you are getting is *not* from pg_partition_root(), but from the
cast from "text" to "regclass":

SELECT 'nonexisting_table'::regclass;
ERROR: relation "nonexisting_table" does not exist
LINE 1: SELECT 'nonexisting_table'::regclass;
^

And if you take a "regclass" that corresponds to an object ID that is not
the object ID of any existing relation, you get a NULL result:

SELECT pg_partition_root('12345'::regclass);

pg_partition_root
-------------------

(1 row)

Yours,
Laurenz Albe