pgsql: Doc: document that we expect CHECK constraint conditions to be i

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: Doc: document that we expect CHECK constraint conditions to be i
Date: 2018-12-07 21:41:06
Message-ID: E1gVNru-000780-Pd@gemulon.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers

Doc: document that we expect CHECK constraint conditions to be immutable.

This restriction is implicit in the check-only-once implementation we use
for table and domain constraints, but it wasn't spelled out anywhere, nor
was there any advice about how to alter a constraint's behavior safely.
Improve that.

I was also dissatisfied with the documentation of ALTER DOMAIN VALIDATE
CONSTRAINT, which entirely failed to explain the use of that feature; and
thence decided that ALTER TABLE VALIDATE CONSTRAINT could be documented
better as well.

Perhaps we should back-patch this, along with the related commit 36d442a25,
but for now I refrained.

Discussion: https://postgr.es/m/12539.1544107316@sss.pgh.pa.us

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/1f66c657f2b4eb55c68593d5c14256115aa6a0ea

Modified Files
--------------
doc/src/sgml/ddl.sgml | 28 ++++++++++++-
doc/src/sgml/ref/alter_domain.sgml | 21 ++++++++--
doc/src/sgml/ref/alter_table.sgml | 83 ++++++++++++++++++++++++-------------
doc/src/sgml/ref/create_domain.sgml | 24 +++++++++++
4 files changed, 123 insertions(+), 33 deletions(-)

Browse pgsql-committers by date

  From Date Subject
Next Message Michael Paquier 2018-12-09 07:41:55 pgsql: Add timestamp of last received message from standby to pg_stat_r
Previous Message Tom Lane 2018-12-07 18:11:34 pgsql: In PQprint(), write HTML table trailer before closing the output