Recommend triggers, not rules, in the CREATE VIEW reference page.

We've generally recommended use of INSTEAD triggers over rules since that
feature was added; but this old text in the CREATE VIEW reference page
didn't get the memo.  Noted by Thomas Kellerer.

diff --git a/doc/src/sgml/ref/create_view.sgml b/doc/src/sgml/ref/create_view.sgml
index 838bf486a3dfa6a5f449b34319c53df6eec6456e..9e3bc2954f2deb472ed4f1298b29a031a3cca753 100644 (file)
--- a/doc/src/sgml/ref/create_view.sgml
+++ b/doc/src/sgml/ref/create_view.sgml
@@ -130,9 +130,12 @@ CREATE [ OR REPLACE ] [ TEMP | TEMPORARY ] VIEW <replaceable class="PARAMETER">n
    <para>
     Currently, views are read only: the system will not allow an insert,
     update, or delete on a view.  You can get the effect of an updatable
-    view by creating rules that rewrite inserts, etc. on the view into
+    view by creating <literal>INSTEAD</> triggers on the view, which
+    must convert attempted inserts, etc. on the view into
     appropriate actions on other tables.  For more information see
-    <xref linkend="sql-createrule">.
+    <xref linkend="sql-createtrigger">.  Another possibility is to create
+    rules (see <xref linkend="sql-createrule">), but in practice triggers
+    are easier to understand and use correctly.
    </para>
 
    <para>