Remove inbound links to sql-createuser

CREATE USER is an alias for CREATE ROLE, not its own command any longer,
so clean up references to the 'sql-createuser' link to go to
'sql-createrole' instead.

In passing, change a few cases of 'CREATE USER' to be
'CREATE ROLE ...  LOGIN'.  The remaining cases appear reasonable and
also mention the distinction between 'CREATE ROLE' and 'CREATE USER'.
Also, don't say CREATE USER "assumes" LOGIN, but rather "includes".

Patch-by: David G. Johnston, with assumes->includes by me.
Discussion: https://postgr.es/m/CAKFQuwYrbhKV8hH4TEABrDRBwf=gKremF=mLPQ6X2yGqxgFpYA@mail.gmail.com

diff --git a/doc/src/sgml/client-auth.sgml b/doc/src/sgml/client-auth.sgml
index 722f3da81389b705ca44f555e3ca7db053b1052f..99921ba079393949799da3415a8bba2e83541d5c 100644 (file)
--- a/doc/src/sgml/client-auth.sgml
+++ b/doc/src/sgml/client-auth.sgml
@@ -998,9 +998,9 @@ omicron         bryanh                  guest1
     separate from operating system user passwords. The password for
     each database user is stored in the pg_authid system
     catalog. Passwords can be managed with the SQL commands
-    user"> and
+    role"> and
     ,
-    e.g., CREATE USER foo WITH PASSWORD 'secret',
+    e.g., CREATE ROLE foo WITH LOGIN PASSWORD 'secret',
     or the psql
     command \password.
     If no password has been set up for a user, the stored password

diff --git a/doc/src/sgml/ref/create_database.sgml b/doc/src/sgml/ref/create_database.sgml
index 3e35c776eadbaed6ff8ad29ef55b425ef0261a1d..f63f1f92ac7fa9771f06cfd69b8293474aa9b819 100644 (file)
--- a/doc/src/sgml/ref/create_database.sgml
+++ b/doc/src/sgml/ref/create_database.sgml
@@ -45,7 +45,7 @@ CREATE DATABASE name
   
    To create a database, you must be a superuser or have the special
    CREATEDB privilege.
-   See user">.
+   See role">.
   
 
   

diff --git a/doc/src/sgml/user-manag.sgml b/doc/src/sgml/user-manag.sgml
index 2416bfd03d8a3a8190193730febf4779c87cd655..94fcdf98298a7a43c539b84c615dd5541fe4fbb2 100644 (file)
--- a/doc/src/sgml/user-manag.sgml
+++ b/doc/src/sgml/user-manag.sgml
@@ -158,7 +158,7 @@ CREATE ROLE name LOGIN;
 CREATE USER name;
 
         (CREATE USER is equivalent to CREATE ROLE
-        except that CREATE USER assumes LOGIN by
+        except that CREATE USER includes LOGIN by
         default, while CREATE ROLE does not.)