Re: nextval parameter is not clear

Поиск
Список
Период
Сортировка
От Kirk Wolak
Тема Re: nextval parameter is not clear
Дата
Msg-id CACLU5mRd-xpVfhmDJwGwM33uV4hovGT85DZbd_F4vAS1FVRMSA@mail.gmail.com
обсуждение исходный текст
Ответ на Re: nextval parameter is not clear  (Tom Lane <tgl@sss.pgh.pa.us>)
Ответы Re: nextval parameter is not clear  (Laurenz Albe <laurenz.albe@cybertec.at>)
Список pgsql-docs
On Mon, Nov 28, 2022 at 12:45 AM Tom Lane <tgl@sss.pgh.pa.us> wrote:
Laurenz Albe <laurenz.albe@cybertec.at> 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:

Yeah, that stuff seems quite out of place here.

> I am alright with having a CREATE TABLE with a DEFAULT and an INSERT or two;
> whatever it takes to show the functions in a realistic scenario.
> For example, you could INSERT a row that overrides the DEFAULT, then call
> "setval()" to readjust the sequence.

I don't believe we have such detail around very many, if indeed any,
of our other functions' documentation.

                        regards, tom lane

All changes specified have been addressed.
The Example is significantly reduced, but readable.
The extra "SELECT "'s have been removed off of the inline examples, excluding the existing paragraph.

This is the smallest possible change, that still has an example.

The "Example" is not <title> as every attempt to make it such fails the LINT process. 

regards, Kirk
Вложения

В списке pgsql-docs по дате отправления:

Предыдущее
От: Matous Jan Fialka
Дата:
Сообщение: Tutorial book with runable code for Postgres?
Следующее
От: Kirk Wolak
Дата:
Сообщение: Re: Tutorial book with runable code for Postgres?