doc: Improve CREATE VIEW / WITH documentation

Similar to 590eb0c14eebe834f716721a9659b77899cf3084, remove the options
list from the synopsis and elaborate in the main description.

diff --git a/doc/src/sgml/ref/create_view.sgml b/doc/src/sgml/ref/create_view.sgml
index 2b7a98fe692571259149eb3588106939c1446107..5dadab1dee9d7b59581a8f61c1e8a508540cabc8 100644 (file)
--- a/doc/src/sgml/ref/create_view.sgml
+++ b/doc/src/sgml/ref/create_view.sgml
@@ -25,11 +25,6 @@ CREATE [ OR REPLACE ] [ TEMP | TEMPORARY ] [ RECURSIVE ] VIEW 
     [ WITH ( view_option_name [= view_option_value] [, ... ] ) ]
     AS query
     [ WITH [ CASCADED | LOCAL ] CHECK OPTION ]
-
-where view_option_name can be one of:
-
-    security_barrier [ boolean ]
-    check_option [ text (local or cascaded) ]
 
  
 
@@ -131,24 +126,24 @@ CREATE VIEW name AS WITH RECURSIVE name (
 
       
        
-        security_barrier(boolean)
+        check_option (string)
         
          
-          This should be used if the view is intended to provide row-level
-          security.  See  for full details.
+          This parameter may be either local or
+          cascaded, and is equivalent to specifying
+          WITH [ CASCADED | LOCAL ] CHECK OPTION (see below).
+          This option can be changed on existing views using 
+          linkend="sql-alterview">.
          
         
        
 
        
-        check_option(text)
+        security_barrier (string)
         
          
-          This parameter may be either local or
-          cascaded, and is equivalent to specifying
-          WITH [ CASCADED | LOCAL ] CHECK OPTION (see below).
-          This option can be changed on existing views using 
-          linkend="sql-alterview">.
+          This should be used if the view is intended to provide row-level
+          security.  See  for full details.