Re: [PATCH] Docs: Make notes on sequences and rollback more obvious

From: "Kevin Grittner" <Kevin(dot)Grittner(at)wicourts(dot)gov>
To: "PostgreSQL Hackers" <pgsql-hackers(at)postgresql(dot)org>, "Craig Ringer" <ringerc(at)ringerc(dot)id(dot)au>
Subject: Re: [PATCH] Docs: Make notes on sequences and rollback more obvious
Date: 2012-08-03 20:12:57
Message-ID: 501BEA7902000025000493EF@gw.wicourts.gov
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Craig Ringer <ringerc(at)ringerc(dot)id(dot)au> wrote:

> I'm seeing enough questions on pgsql-general and stack overflow
> to suggest that the docs for how sequences interact with
> transaction rollback.

Yeah, I've noticed a surprising number of people who are being
surprised by the non-transactional nature of sequences (and serial
columns) in spite of current caveats in the docs; so I agree that we
should punch that up in the docs a bit.

> The attached patch:
>
> - Moves the note about nextval() from the footer to be inside the
> nextval description
>
> - Adds an xref from the advanced-transactions tutorial where the
> poster noted their point of confusion, noting the exemption and
> pointing to the docs on nextval.
>
> - A pointer from the docs on SERIAL types to the nextval notes on
> tx rollback.
>
> Comments would be appreciated.

I haven't reviewed it in detail but noticed an apparent editing
error: "which are used the counters" should probably have an "as"
thrown in there. Or something.

-Kevin

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Tom Lane 2012-08-03 20:18:03 Re: Issue in Behavior of Interval Datatype
Previous Message Heikki Linnakangas 2012-08-03 20:03:00 Re: [WIP] Performance Improvement by reducing WAL for Update Operation