Add an example of attaching a default value to an updatable view.

This is probably the single most useful thing that ALTER VIEW can do,
particularly now that we have auto-updatable views.  So show an explicit
example.

diff --git a/doc/src/sgml/ref/alter_view.sgml b/doc/src/sgml/ref/alter_view.sgml
index 0e2b140241e3ada358795f6bd2a1f9520d0b8088..55674c650a98b43afecee64b2c37edb1f8a50838 100644 (file)
--- a/doc/src/sgml/ref/alter_view.sgml
+++ b/doc/src/sgml/ref/alter_view.sgml
@@ -154,7 +154,19 @@ ALTER VIEW [ IF EXISTS ] name RESET
    bar:
 
 ALTER VIEW foo RENAME TO bar;
-
+
+  
+
+  
+   To attach a default column value to an updatable view:
+
+CREATE TABLE base_table (id int, ts timestamptz);
+CREATE VIEW a_view AS SELECT * FROM base_table;
+ALTER VIEW a_view ALTER COLUMN ts SET DEFAULT now();
+INSERT INTO base_table(id) VALUES(1);  -- ts will receive a NULL
+INSERT INTO a_view(id) VALUES(2);  -- ts will receive the current time
+
+