Remove documentation of equals in CREATE DATABASE. Mention removal of

equals hack for the future.

diff --git a/doc/src/sgml/ref/create_database.sgml b/doc/src/sgml/ref/create_database.sgml
index 2c87d215914b1497833918ebb7e33f0f9098a189..0ee73e3726514a5009ceb6ccc220a520a0a55d14 100644 (file)
--- a/doc/src/sgml/ref/create_database.sgml
+++ b/doc/src/sgml/ref/create_database.sgml
@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_database.sgml,v 1.24 2002/02/24 20:20:18 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_database.sgml,v 1.25 2002/02/25 02:53:46 momjian Exp $
 PostgreSQL documentation
 -->
 
@@ -24,10 +24,10 @@ PostgreSQL documentation
   </refsynopsisdivinfo>
   <synopsis>
 CREATE DATABASE <replaceable class="PARAMETER">name</replaceable>
-    [ WITH [ OWNER [ = ] <replaceable class="parameter">dbowner</replaceable> ]
-           [ LOCATION [ = ] '<replaceable class="parameter">dbpath</replaceable>' ]
-           [ TEMPLATE [ = ] <replaceable class="parameter">template</replaceable> ]
-           [ ENCODING [ = ] <replaceable class="parameter">encoding</replaceable> ] ]
+    [ WITH [ OWNER <replaceable class="parameter">dbowner</replaceable> ]
+           [ LOCATION '<replaceable class="parameter">dbpath</replaceable>' ]
+           [ TEMPLATE <replaceable class="parameter">template</replaceable> ]
+           [ ENCODING <replaceable class="parameter">encoding</replaceable> ] ]
   </synopsis>
 
   <refsect2 id="R2-SQL-CREATEDATABASE-1">
@@ -186,11 +186,10 @@ CREATE DATABASE <replaceable class="PARAMETER">name</replaceable>
 
   <para>
    Normally, the creator becomes the owner of the new database.
-   A different owner may be specified by using the <option>OWNER</>
-   clause (but only superusers may create databases on behalf of other users).
-   To create a database owned by oneself, either superuser privilege
-   or CREATEDB privilege is required.  A superuser may create a database
-   for another user, even if that user has no special privileges himself.
+   Superusers can create databases owned by other users using the
+   <option>OWNER</> clause. They can even create databases owned by
+   users with no special privileges. Non-superusers with CREATEDB
+   privilege can only create databases owned by themselves.
   </para>
 
   <para>

diff --git a/src/backend/parser/gram.y b/src/backend/parser/gram.y
index 37d9364eae8154dfa663bf576d07d7e828a71794..66c11828b6598e8c2a37fd3863e3047245b2de26 100644 (file)
--- a/src/backend/parser/gram.y
+++ b/src/backend/parser/gram.y
@@ -11,7 +11,7 @@
  *
  *
  * IDENTIFICATION
- *       $Header: /cvsroot/pgsql/src/backend/parser/gram.y,v 2.279 2002/02/24 20:20:20 tgl Exp $
+ *       $Header: /cvsroot/pgsql/src/backend/parser/gram.y,v 2.280 2002/02/25 02:53:46 momjian Exp $
  *
  * HISTORY
  *       AUTHOR                        DATE                    MAJOR EVENT
@@ -3155,6 +3155,10 @@ createdb_opt_item:  LOCATION opt_equal Sconst
                                }
                ;
 
+/*
+ *     Optional equals is here only for backward compatibility.
+ *     Should be removed someday.  bjm 2002-02-24
+ */
 opt_equal: '='                                                         { $$ = TRUE; }
                | /*EMPTY*/                                                     { $$ = FALSE; }
                ;