Count parameter for cursor_to_xml

Started by PG Bug reporting formover 1 year ago2 messagesdocs
Jump to latest
#1PG Bug reporting form
noreply@postgresql.org

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/16/functions-xml.html
Description:

cursor_to_xml ( cursor refcursor, count integer, nulls boolean,
tableforest boolean, targetns text ) → xml

There is not explanation what the count parameter do.

#2Daniel Gustafsson
daniel@yesql.se
In reply to: PG Bug reporting form (#1)
Re: Count parameter for cursor_to_xml

On 25 Sep 2024, at 10:50, PG Doc comments form <noreply@postgresql.org> wrote:

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/16/functions-xml.html
Description:

cursor_to_xml ( cursor refcursor, count integer, nulls boolean,
tableforest boolean, targetns text ) → xml

There is not explanation what the count parameter do.

It's described in the function text without the name of the parameter being
explicitly mentioned:

"cursor_to_xml fetches the indicated number of rows from the cursor
specified by the parameter cursor"

That could be rewritten to include the name of the parameter like: "fetches the
number of rows indicated by the parameter count from the cursor specified by
the parameter cursor". We do mention every other parameter explicitly so it
would make sense to do so here as well.

--
Daniel Gustafsson