Re: nextval parameter is not clear - Mailing list pgsql-docs

From Laurenz Albe
Subject Re: nextval parameter is not clear
Date
Msg-id 47353838812604058c965ee721bade7260787d83.camel@cybertec.at
Whole thread Raw
In response to Re: nextval parameter is not clear  ("David G. Johnston" <david.g.johnston@gmail.com>)
List pgsql-docs
On Wed, 2022-12-07 at 14:32 -0700, David G. Johnston wrote:
> While I agree with the conclusion that the function signature is an example,
> and having more than one for these is probably overkill, we can address the
> OP's complaint quite easily by doing what we do in many other places, give
> each parameter in the function signature a name.  I've modified v9 to include
> those and attach it here as v10.  I do think this suffices as a response
> to this complaint.
> 
> Bikeshedding on the names for setval, and maybe an attempt to incorporate
> the parameter name into the prose, can be considered, though.

Thanks for looking into that, and parameter names are fully sufficient to
clarify the usage.

Your patch is good, except that you forgot to add the link target on the CREATE
SEQUENCE page.

> My thoughts regarding incorporating pg_get_serial_sequence and usage of these
> functions in a more common, GENERATED AS IDENTITY environment, can be considered
> in a separate thread should I or anyone else wish to do so.

+1

Yours,
Laurenz Albe



pgsql-docs by date:

Previous
From: Vik Fearing
Date:
Subject: Clarify note about DISTINCT and ORDER BY in aggregates
Next
From: "David G. Johnston"
Date:
Subject: Re: Clarify note about DISTINCT and ORDER BY in aggregates