Re: nextval parameter is not clear

2022-12-08 Thread Laurenz Albe
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 >

Re: nextval parameter is not clear

2022-12-07 Thread David G. Johnston
On Sat, Dec 3, 2022 at 8:03 PM Kirk Wolak wrote: > On Thu, Dec 1, 2022 at 4:21 PM Laurenz Albe > wrote: > >> On Tue, 2022-11-29 at 16:26 -0500, Kirk Wolak wrote: >> > On Mon, Nov 28, 2022 at 12:45 AM Tom Lane wrote: >> > > Laurenz Albe writes: >> > > > Now I think that is taking it too far.

Re: nextval parameter is not clear

2022-12-05 Thread Александр Илюшкин
That was feedback on my issue I've never seen before. Thanks so much to all of you. С уважением, А. И. вс, 4 дек. 2022 г., 06:03 Kirk Wolak : > On Thu, Dec 1, 2022 at 4:21 PM Laurenz Albe > wrote: > >> On Tue, 2022-11-29 at 16:26 -0500, Kirk Wolak wrote: >> > On Mon, Nov 28, 2022 at 12:45 AM

Re: nextval parameter is not clear

2022-12-03 Thread Kirk Wolak
On Thu, Dec 1, 2022 at 4:21 PM Laurenz Albe wrote: > On Tue, 2022-11-29 at 16:26 -0500, Kirk Wolak wrote: > > On Mon, Nov 28, 2022 at 12:45 AM Tom Lane wrote: > > > Laurenz Albe writes: > > > > Now I think that is taking it too far. Your code sample would be > great > > > > for a tutorial,

Re: nextval parameter is not clear

2022-12-01 Thread Laurenz Albe
On Tue, 2022-11-29 at 16:26 -0500, Kirk Wolak wrote: > On Mon, Nov 28, 2022 at 12:45 AM Tom Lane wrote: > > Laurenz Albe writes: > > > Now I think that is taking it too far.  Your code sample would be great > > > for a tutorial, but it is too elaborate for the technical documentation. > > > The

Re: nextval parameter is not clear

2022-11-29 Thread Kirk Wolak
On Mon, Nov 28, 2022 at 12:45 AM Tom Lane wrote: > Laurenz Albe writes: > > Now I think that is taking it too far. Your code sample would be great > > for a tutorial, but it is too elaborate for the technical documentation. > > The example should focus on the sequence functions, but more than

Re: nextval parameter is not clear

2022-11-28 Thread David G. Johnston
On Mon, Nov 28, 2022 at 12:22 PM Kirk Wolak wrote: > On Mon, Nov 28, 2022 at 12:47 PM Tom Lane wrote: > >> Kirk Wolak writes: >> > my goal is to get an "approach" accepted, this is the first. >> Ultimately, I >> > would love to see >> > the documentation of functions with examples like this

Re: nextval parameter is not clear

2022-11-28 Thread Kirk Wolak
On Mon, Nov 28, 2022 at 12:47 PM Tom Lane wrote: > Kirk Wolak writes: > > my goal is to get an "approach" accepted, this is the first. > Ultimately, I > > would love to see > > the documentation of functions with examples like this everywhere. > > I'm not for that. func.sgml is already

Re: nextval parameter is not clear

2022-11-28 Thread Tom Lane
Kirk Wolak writes: > my goal is to get an "approach" accepted, this is the first. Ultimately, I > would love to see > the documentation of functions with examples like this everywhere. I'm not for that. func.sgml is already massive, and doubling its size with extensive examples doesn't seem

Re: nextval parameter is not clear

2022-11-28 Thread Kirk Wolak
On Sun, Nov 27, 2022 at 10:34 PM Laurenz Albe wrote: > On Sat, 2022-11-26 at 23:22 -0500, Kirk Wolak wrote: > > Your feedback would be appreciated. > > + Example > > I think you should use the tag to render that more conspicuous. > > I tried. it does not MAKE. It is not allowed in that

Re: nextval parameter is not clear

2022-11-28 Thread Kirk Wolak
On Mon, Nov 28, 2022 at 12:45 AM Tom Lane wrote: > Laurenz Albe writes: > > Now I think that is taking it too far. Your code sample would be great > > for a tutorial, but it is too elaborate for the technical documentation. > > The example should focus on the sequence functions, but more than

Re: nextval parameter is not clear

2022-11-27 Thread Tom Lane
Laurenz Albe writes: > Now I think that is taking it too far. Your code sample would be great > for a tutorial, but it is too elaborate for the technical documentation. > The example should focus on the sequence functions, but more than half > of the code describes other parts of PostgreSQL:

Re: nextval parameter is not clear

2022-11-27 Thread Laurenz Albe
On Sat, 2022-11-26 at 23:22 -0500, Kirk Wolak wrote: > Your feedback would be appreciated. > --- a/doc/src/sgml/func.sgml > +++ b/doc/src/sgml/func.sgml > @@ -17625,6 +17625,11 @@ $.* ? (@ like_regex "^\\d+$") > command. > > > + > +SELECT nextval('myseq'::regclass); > +

Re: nextval parameter is not clear

2022-11-26 Thread Kirk Wolak
On Fri, Nov 25, 2022 at 10:06 PM Kirk Wolak wrote: > On Fri, Nov 25, 2022 at 9:58 AM David G. Johnston < > david.g.johns...@gmail.com> wrote: > >> On Fri, Nov 25, 2022 at 12:40 AM Laurenz Albe >> wrote: >> >>> On Thu, 2022-11-24 at 15:50 -0500, Kirk Wolak wrote: >>> >> .. > Regardless of the

Re: nextval parameter is not clear

2022-11-25 Thread Kirk Wolak
On Fri, Nov 25, 2022 at 9:58 AM David G. Johnston < david.g.johns...@gmail.com> wrote: > On Fri, Nov 25, 2022 at 12:40 AM Laurenz Albe > wrote: > >> On Thu, 2022-11-24 at 15:50 -0500, Kirk Wolak wrote: >> > >> > David, let me see how that looks. From an approach standpoint, I am >> hearing: >>

Re: nextval parameter is not clear

2022-11-25 Thread Kirk Wolak
On Fri, Nov 25, 2022 at 9:58 AM David G. Johnston < david.g.johns...@gmail.com> wrote: > On Fri, Nov 25, 2022 at 12:40 AM Laurenz Albe > wrote: > >> On Thu, 2022-11-24 at 15:50 -0500, Kirk Wolak wrote: >> > >> > David, let me see how that looks. From an approach standpoint, I am >> hearing: >>

Re: nextval parameter is not clear

2022-11-25 Thread David G. Johnston
On Fri, Nov 25, 2022 at 12:40 AM Laurenz Albe wrote: > On Thu, 2022-11-24 at 15:50 -0500, Kirk Wolak wrote: > > > > David, let me see how that looks. From an approach standpoint, I am > hearing: > > 1) Keep the example near the definition minimal [just this function] > > 2) It's okay to create

Re: nextval parameter is not clear

2022-11-24 Thread Laurenz Albe
On Thu, 2022-11-24 at 15:50 -0500, Kirk Wolak wrote: > > David, let me see how that looks.  From an approach standpoint, I am hearing: > 1) Keep the example near the definition minimal [just this function] > 2) It's okay to create an extra "row" [each function is in a ], right > after the last

Re: nextval parameter is not clear

2022-11-24 Thread Kirk Wolak
On Thu, Nov 24, 2022 at 10:44 AM David G. Johnston < david.g.johns...@gmail.com> wrote: > On Thu, Nov 24, 2022 at 7:33 AM Kirk Wolak wrote: > >> On Thu, Nov 24, 2022 at 5:33 AM Laurenz Albe >> wrote: >> >>> On Thu, 2022-11-24 at 02:41 -0500, Kirk Wolak wrote: >>> > Alright, as I have the

Re: nextval parameter is not clear

2022-11-24 Thread David G. Johnston
On Thu, Nov 24, 2022 at 7:33 AM Kirk Wolak wrote: > On Thu, Nov 24, 2022 at 5:33 AM Laurenz Albe > wrote: > >> On Thu, 2022-11-24 at 02:41 -0500, Kirk Wolak wrote: >> > Alright, as I have the documentation build working, and a slightly >> better stylesheet, >> > the comments on the last block

Re: nextval parameter is not clear

2022-11-24 Thread Kirk Wolak
On Thu, Nov 24, 2022 at 5:33 AM Laurenz Albe wrote: > On Thu, 2022-11-24 at 02:41 -0500, Kirk Wolak wrote: > > Alright, as I have the documentation build working, and a slightly > better stylesheet, > > the comments on the last block were not aligned. > > They are fixed now. > > > > Apologies

Re: nextval parameter is not clear

2022-11-24 Thread Laurenz Albe
On Thu, 2022-11-24 at 02:41 -0500, Kirk Wolak wrote: > Alright, as I have the documentation build working, and a slightly better > stylesheet, > the comments on the last block were not aligned. > They are fixed now. > > Apologies for spamming this in...  My first patch turned into 3 emails... 

Re: nextval parameter is not clear

2022-11-23 Thread Kirk Wolak
On Thu, Nov 24, 2022 at 2:04 AM Kirk Wolak wrote: > On Wed, Nov 23, 2022 at 11:06 PM Kirk Wolak wrote: > >> On Tue, Nov 22, 2022 at 11:43 PM David G. Johnston < >> david.g.johns...@gmail.com> wrote: >> >>> On Tue, Nov 22, 2022 at 8:42 PM Kirk Wolak wrote: >>> Here is the updated version.

Re: nextval parameter is not clear

2022-11-23 Thread Kirk Wolak
On Wed, Nov 23, 2022 at 11:06 PM Kirk Wolak wrote: > On Tue, Nov 22, 2022 at 11:43 PM David G. Johnston < > david.g.johns...@gmail.com> wrote: > >> On Tue, Nov 22, 2022 at 8:42 PM Kirk Wolak wrote: >> >>> >>> .. >> The wiki is an excellent place to prototype and coordinate. Beyond that, >>

Re: nextval parameter is not clear

2022-11-23 Thread Kirk Wolak
On Tue, Nov 22, 2022 at 11:43 PM David G. Johnston < david.g.johns...@gmail.com> wrote: > On Tue, Nov 22, 2022 at 8:42 PM Kirk Wolak wrote: > >> >> >> On Tue, Nov 22, 2022 at 2:10 PM Bruce Momjian wrote: >> >>> On Tue, Oct 18, 2022 at 08:17:12AM +, PG Doc comments form wrote: >>> > The

Re: nextval parameter is not clear

2022-11-22 Thread David G. Johnston
On Tue, Nov 22, 2022 at 8:42 PM Kirk Wolak wrote: > > > On Tue, Nov 22, 2022 at 2:10 PM Bruce Momjian wrote: > >> On Tue, Oct 18, 2022 at 08:17:12AM +, PG Doc comments form wrote: >> > The following documentation comment has been logged on the website: >> > >> > Page:

Re: nextval parameter is not clear

2022-11-22 Thread Kirk Wolak
On Tue, Nov 22, 2022 at 2:10 PM Bruce Momjian wrote: > On Tue, Oct 18, 2022 at 08:17:12AM +, PG Doc comments form wrote: > > The following documentation comment has been logged on the website: > > > > Page: https://www.postgresql.org/docs/14/functions-sequence.html > > Description: > > > >

Re: nextval parameter is not clear

2022-11-22 Thread Bruce Momjian
On Tue, Oct 18, 2022 at 08:17:12AM +, PG Doc comments form wrote: > The following documentation comment has been logged on the website: > > Page: https://www.postgresql.org/docs/14/functions-sequence.html > Description: > > https://www.postgresql.org/docs/14/functions-sequence.html > > I

nextval parameter is not clear

2022-10-18 Thread PG Doc comments form
The following documentation comment has been logged on the website: Page: https://www.postgresql.org/docs/14/functions-sequence.html Description: https://www.postgresql.org/docs/14/functions-sequence.html I don't see here any hints about how to use this function, and what the regclass means.