postgres.git / summary / log / commit / refs

commit    1b795ef0329d64427f3e779e38c7c492c0a15e5d
Author:   Fujii Masao <fujii@postgresql.org>
Date:     Wed Jan 07 16:10:36 2026 +0000

    doc: Remove deprecated clauses from CREATE USER/GROUP syntax synopsis.
    
    The USER and IN GROUP clauses of CREATE ROLE are deprecated, and
    commit 8e78f0a1 removed them from the CREATE ROLE syntax syntax
    synopsis in the docs. However, previously CREATE USER and
    CREATE GROUP docs still listed these clauses.
    
    Since CREATE USER is equivalent to CREATE ROLE ... WITH LOGIN and
    CREATE GROUP is equivalent to CREATE ROLE, their documented syntax
    synopsis should match CREATE ROLE to avoid confusion.
    
    Therefore this commit removes the deprecated USER and IN GROUP
    clauses from the CREATE USER and CREATE GROUP syntax synopsis
    in the docs.
    
    Author: Japin Li <japinli@hotmail.com>
    Reviewed-by: wenhui qiu <qiuwenhuifx@gmail.com>
    Reviewed-by: Chao Li <li.evan.chao@gmail.com>
    Reviewed-by: Fujii Masao <masao.fujii@gmail.com>
    Discussion: https://postgr.es/m/MEAPR01MB3031C30E72EF16CFC08C8565B687A@MEAPR01MB3031.ausprd01.prod.outlook.com


 doc/src/sgml/ref/create_group.sgml | 2 --
 doc/src/sgml/ref/create_user.sgml  | 2 --
 2 files changed, 4 deletions(-)

diff --git a/doc/src/sgml/ref/create_group.sgml b/doc/src/sgml/ref/create_group.sgml
index d124c98eb51..119d5ff3eb4 100644
--- a/doc/src/sgml/ref/create_group.sgml
+++ b/doc/src/sgml/ref/create_group.sgml
@@ -36,10 +36,8 @@ CREATE GROUP <replaceable class="parameter">name</replaceable> [ [ WITH ] <repla
     | [ ENCRYPTED ] PASSWORD '<replaceable class="parameter">password</replaceable>' | PASSWORD NULL
     | VALID UNTIL '<replaceable class="parameter">timestamp</replaceable>'
     | IN ROLE <replaceable class="parameter">role_name</replaceable> [, ...]
-    | IN GROUP <replaceable class="parameter">role_name</replaceable> [, ...]
     | ROLE <replaceable class="parameter">role_name</replaceable> [, ...]
     | ADMIN <replaceable class="parameter">role_name</replaceable> [, ...]
-    | USER <replaceable class="parameter">role_name</replaceable> [, ...]
     | SYSID <replaceable class="parameter">uid</replaceable>
 </synopsis>
  </refsynopsisdiv>
diff --git a/doc/src/sgml/ref/create_user.sgml b/doc/src/sgml/ref/create_user.sgml
index 48d2089238c..8a138c001c2 100644
--- a/doc/src/sgml/ref/create_user.sgml
+++ b/doc/src/sgml/ref/create_user.sgml
@@ -36,10 +36,8 @@ CREATE USER <replaceable class="parameter">name</replaceable> [ [ WITH ] <replac
     | [ ENCRYPTED ] PASSWORD '<replaceable class="parameter">password</replaceable>' | PASSWORD NULL
     | VALID UNTIL '<replaceable class="parameter">timestamp</replaceable>'
     | IN ROLE <replaceable class="parameter">role_name</replaceable> [, ...]
-    | IN GROUP <replaceable class="parameter">role_name</replaceable> [, ...]
     | ROLE <replaceable class="parameter">role_name</replaceable> [, ...]
     | ADMIN <replaceable class="parameter">role_name</replaceable> [, ...]
-    | USER <replaceable class="parameter">role_name</replaceable> [, ...]
     | SYSID <replaceable class="parameter">uid</replaceable>
 </synopsis>
  </refsynopsisdiv>


[parent: e54ce0b2da62]