Documentation incorrect pg_partition_root function description. - Mailing list pgsql-docs

From PG Doc comments form
Subject Documentation incorrect pg_partition_root function description.
Date
Msg-id 177226779035.3161255.9286174854079010253@wrigleys.postgresql.org
Whole thread Raw
Responses Re: Documentation incorrect pg_partition_root function description.
List pgsql-docs
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




pgsql-docs by date:

Previous
From: "David G. Johnston"
Date:
Subject: Re: A suggestion about the usage manual of \d command
Next
From: "Radoulov, Dimitre"
Date:
Subject: Re: Documentation clarification request: pg_dumpall and Large Objects