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

From: Craig Ringer <ringerc(at)ringerc(dot)id(dot)au>
To: PostgreSQL Hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: [PATCH] Docs: Make notes on sequences and rollback more obvious
Date: 2012-08-03 13:55:42
Message-ID: 501BD85E.6030808@ringerc.id.au
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Hi all

I'm seeing enough questions on pgsql-general and stack overflow to
suggest that the docs for how sequences interact with transaction
rollback. Take the most recent post on -general, where the person read
at least the tutorial, but had no idea about the exemption.

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.

--
Craig Ringer

Attachment Content-Type Size
belabour-the-point-on-sequence-rollback.diff text/x-patch 5.0 KB

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Bruce Momjian 2012-08-03 13:59:36 Re: Word-smithing doc changes
Previous Message Robert Haas 2012-08-03 12:38:52 Re: WIP Patch: Use sortedness of CSV foreign tables for query planning