aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTom Lane <tgl@sss.pgh.pa.us>2023-12-27 13:52:01 -0500
committerTom Lane <tgl@sss.pgh.pa.us>2023-12-27 13:52:20 -0500
commit2ad96ebbfd10896c6d4a16bf9f64a09f426244bf (patch)
tree3d1a6ceb821a461492a710f1a392de20746ce46d
parent76dd3d94a50435f57efc4da29e27a1bf69862726 (diff)
downloadpostgresql-2ad96ebbfd10896c6d4a16bf9f64a09f426244bf.tar.gz
postgresql-2ad96ebbfd10896c6d4a16bf9f64a09f426244bf.zip
Doc: specify aclitem syntax more clearly.
The previous wording here relied solely on an example to explain aclitem output format. Add an actual syntax synopsis and explanation of the elements to make it clearer. David Johnston and Tom Lane, per gripe from Eugen Konkov. Discussion: https://postgr.es/m/170326116972.1876499.18357820037829248593@wrigleys.postgresql.org
-rw-r--r--doc/src/sgml/ddl.sgml13
1 files changed, 10 insertions, 3 deletions
diff --git a/doc/src/sgml/ddl.sgml b/doc/src/sgml/ddl.sgml
index fc0087c6cd3..bda152c38fc 100644
--- a/doc/src/sgml/ddl.sgml
+++ b/doc/src/sgml/ddl.sgml
@@ -2253,9 +2253,16 @@ REVOKE ALL ON accounts FROM PUBLIC;
<primary><type>aclitem</type></primary>
</indexterm>
The privileges that have been granted for a particular object are
- displayed as a list of <type>aclitem</type> entries, where each
- <type>aclitem</type> describes the permissions of one grantee that
- have been granted by a particular grantor. For example,
+ displayed as a list of <type>aclitem</type> entries, each having the
+ format:
+<synopsis>
+<replaceable>grantee</replaceable><literal>=</literal><replaceable>privilege-abbreviation</replaceable><optional><literal>*</literal></optional>...<literal>/</literal><replaceable>grantor</replaceable>
+</synopsis>
+ Each <type>aclitem</type> lists all the permissions of one grantee that
+ have been granted by a particular grantor. Specific privileges are
+ represented by one-letter abbreviations from
+ <xref linkend="privilege-abbrevs-table"/>, with <literal>*</literal>
+ appended if the privilege was granted with grant option. For example,
<literal>calvin=r*w/hobbes</literal> specifies that the role
<literal>calvin</literal> has the privilege
<literal>SELECT</literal> (<literal>r</literal>) with grant option