Thread: Count parameter for cursor_to_xml

Count parameter for cursor_to_xml

From
PG Doc comments form
Date:
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.

Re: Count parameter for cursor_to_xml

From
Daniel Gustafsson
Date:
> 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