docs: improve 'capitals' inheritance example

Adds constraints and improves wording.

Reported-by: [email protected]
Discussion: https://postgr.es/m/159586122762.680.1361378513036616007@wrigleys.postgresql.org

Backpatch-through: 9.5

diff --git a/doc/src/sgml/advanced.sgml b/doc/src/sgml/advanced.sgml
index d77312600f7b6bd2e52208604c8977c8fa9d6ebb..2d4ab85d450c18dadd09f3efbdfef199688f8246 100644 (file)
--- a/doc/src/sgml/advanced.sgml
+++ b/doc/src/sgml/advanced.sgml
@@ -616,7 +616,7 @@ CREATE TABLE cities (
 );
 
 CREATE TABLE capitals (
-  state      char(2)
+  state      char(2) UNIQUE NOT NULL
 ) INHERITS (cities);
 
    
@@ -630,7 +630,8 @@ CREATE TABLE capitals (
     text, a native PostgreSQL
     type for variable length character strings.  The
     capitals table has
-    an extra column, state, which shows their states.  In
+    an additional column, state, which shows its
+    state abbreviation.  In
     PostgreSQL, a table can inherit from
     zero or more other tables.