From: Bruce Momjian <bruce@momjian.us>
Date: Mon, 26 May 2003 17:50:09 +0000 (+0000)
Subject: Add documentation to 'createuser' that ALTER USER must be used to add or
X-Git-Tag: REL9_0_0~15257
X-Git-Url: http://git.osdn.net/view?a=commitdiff_plain;h=b71a48990a57647025780363e01b66c0ef8198b5;p=pg-rex%2Fsyncrep.git

Add documentation to 'createuser' that ALTER USER must be used to add or
modify passwords, per user confusion report.

Also clean up wording that command line utils need database access.
---

diff --git a/doc/src/sgml/ref/createdb.sgml b/doc/src/sgml/ref/createdb.sgml
index c202c52c12..0ad159842a 100644
--- a/doc/src/sgml/ref/createdb.sgml
+++ b/doc/src/sgml/ref/createdb.sgml
@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/createdb.sgml,v 1.32 2003/03/24 14:32:51 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/createdb.sgml,v 1.33 2003/05/26 17:50:09 momjian Exp $
 PostgreSQL documentation
 -->
 
@@ -44,11 +44,11 @@ PostgreSQL documentation
   <para>
    <application>createdb</application> is a wrapper around the
    <acronym>SQL</acronym> command <xref linkend="SQL-CREATEDATABASE"
-   endterm="SQL-CREATEDATABASE-title">.  Thus, there is nothing
-   special about creating databases via this or other methods.  This
-   means that a database server must be running at the targeted
-   host. Also, any default settings and environment variables used by
-   the <application>libpq</application> front-end library will apply.
+   endterm="SQL-CREATEDATABASE-title">.  The database server must be 
+   running on the targeted host. There is nothing special about creating 
+   databases via this or other methods.  Also, any default settings and 
+   environment variables used by the <application>libpq</application> 
+   front-end library will apply.
   </para>
  </refsect1>
 
diff --git a/doc/src/sgml/ref/createuser.sgml b/doc/src/sgml/ref/createuser.sgml
index eeafdb944f..13ba5a6fed 100644
--- a/doc/src/sgml/ref/createuser.sgml
+++ b/doc/src/sgml/ref/createuser.sgml
@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/createuser.sgml,v 1.32 2003/03/24 14:32:51 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/createuser.sgml,v 1.33 2003/05/26 17:50:09 momjian Exp $
 PostgreSQL documentation
 -->
 
@@ -45,13 +45,19 @@ PostgreSQL documentation
   <para>
    <application>createuser</application> is a wrapper around the
    <acronym>SQL</acronym> command <xref linkend="SQL-CREATEUSER"
-   endterm="SQL-CREATEUSER-title">.  Thus, there is nothing special
-   about creating users via this or other methods. This means that a
-   database server must be running at the targeted host. Also, any
+   endterm="SQL-CREATEUSER-title">.  The database server must be 
+   running on the targeted host. There is nothing special
+   about creating users via this or other methods. Also, any
    default settings and environment variables used by the
    <application>libpq</application> front-end library will apply.
   </para>
 
+  <para>
+   Passwords can only be added later, changed, or removed using the
+   <acronym>SQL</acronym> command <xref linkend="SQL-ALTERUSER" 
+   endterm="SQL-ALTERUSER-title">.
+  </para>
+
  </refsect1>
 
 
diff --git a/doc/src/sgml/ref/dropdb.sgml b/doc/src/sgml/ref/dropdb.sgml
index 107718d5ac..e029b1a6a3 100644
--- a/doc/src/sgml/ref/dropdb.sgml
+++ b/doc/src/sgml/ref/dropdb.sgml
@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/dropdb.sgml,v 1.21 2003/03/24 14:32:51 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/dropdb.sgml,v 1.22 2003/05/26 17:50:09 momjian Exp $
 PostgreSQL documentation
 -->
 
@@ -37,11 +37,11 @@ PostgreSQL documentation
   <para>
    <application>dropdb</application> is a wrapper around the
    <acronym>SQL</acronym> command <xref linkend="SQL-DROPDATABASE"
-   endterm="SQL-DROPDATABASE-title">.  Thus, there is nothing special
-   about dropping databases via this or other methods. This means that
-   a database server is running at the targeted host. Also, any
+   endterm="SQL-DROPDATABASE-title">.  The database server must be 
+   running on the targeted host. There is nothing special
+   about dropping databases via this or other methods. Also, any
    default settings and environment variables used by the
-   <application>libpq</application> front-end library do apply.
+   <application>libpq</application> front-end library will apply.
   </para>
  </refsect1>
 
diff --git a/doc/src/sgml/ref/dropuser.sgml b/doc/src/sgml/ref/dropuser.sgml
index 67536993e5..d781b2a64f 100644
--- a/doc/src/sgml/ref/dropuser.sgml
+++ b/doc/src/sgml/ref/dropuser.sgml
@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/dropuser.sgml,v 1.24 2003/03/24 14:32:51 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/dropuser.sgml,v 1.25 2003/05/26 17:50:09 momjian Exp $
 PostgreSQL documentation
 -->
 
@@ -39,12 +39,11 @@ PostgreSQL documentation
   <para>
    <application>dropuser</application> is a shell script wrapper
    around the <acronym>SQL</acronym> command <xref
-   linkend="SQL-DROPUSER" endterm="SQL-DROPUSER-title">.  Thus, there
+   linkend="SQL-DROPUSER" endterm="SQL-DROPUSER-title">.  The database 
+   server must be running on the targeted host. There
    is nothing special about removing users via this or other
-   methods. This means that a database server is running at the
-   targeted host. Also, any default settings and environment variables
-   used by the <application>libpq</application> front-end library do
-   apply.
+   methods. Also, any default settings and environment variables
+   used by the <application>libpq</application> front-end library will apply.
   </para>
  </refsect1>