From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Fri, 10 Aug 2001 23:49:20 +0000 (+0000)
Subject: Document column-name-list option of CREATE VIEW ... which has been there
X-Git-Tag: REL7_2_BETA1~717
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=548512ad0397b1e6fe1b079496882b924bbdd745;p=postgresql

Document column-name-list option of CREATE VIEW ... which has been there
awhile, but the man page didn't know it.
---

diff --git a/doc/src/sgml/ref/create_view.sgml b/doc/src/sgml/ref/create_view.sgml
index 8132e41d42..f13dee1dd4 100644
--- a/doc/src/sgml/ref/create_view.sgml
+++ b/doc/src/sgml/ref/create_view.sgml
@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_view.sgml,v 1.10 2001/01/13 23:58:55 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_view.sgml,v 1.11 2001/08/10 23:49:20 tgl Exp $
 Postgres documentation
 -->
 
@@ -23,7 +23,8 @@ Postgres documentation
    <date>2000-03-25</date>
   </refsynopsisdivinfo>
   <synopsis>
-CREATE VIEW <replaceable class="PARAMETER">view</replaceable> AS SELECT <replaceable class="PARAMETER">query</replaceable>
+CREATE VIEW <replaceable class="PARAMETER">view</replaceable> [ ( <replaceable
+class="PARAMETER">column name list</replaceable> ) ] AS SELECT <replaceable class="PARAMETER">query</replaceable>
   </synopsis>
 
   <refsect2 id="R2-SQL-CREATEVIEW-1">
@@ -44,6 +45,16 @@ CREATE VIEW <replaceable class="PARAMETER">view</replaceable> AS SELECT <replace
        </para>
       </listitem>
      </varlistentry>
+     <varlistentry>
+      <term><replaceable class="parameter">column name list</replaceable></term>
+      <listitem>
+       <para>
+        An optional list of names to be used for columns of the view.
+	If given, these names override the column names that would be
+	deduced from the SQL query.
+       </para>
+      </listitem>
+     </varlistentry>
      <varlistentry>
       <term><replaceable class="parameter">query</replaceable></term>
       <listitem>
@@ -124,7 +135,7 @@ CREATE VIEW vista AS SELECT text 'Hello World'
   </title>
   <para>
    <command>CREATE VIEW</command> will define a view of a table.
-   This view is not physically materialized. Specifically, a query
+   The view is not physically materialized. Instead, a query
    rewrite retrieve rule is automatically generated to support
    retrieve operations on views.
   </para>