Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content

Commit 456b6b6

Browse files
committed
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
1 parent ea61b1c commit 456b6b6

File tree

1 file changed

+10
-3
lines changed

1 file changed

+10
-3
lines changed

doc/src/sgml/ddl.sgml

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2126,9 +2126,16 @@ REVOKE ALL ON accounts FROM PUBLIC;
21262126
<primary><type>aclitem</type></primary>
21272127
</indexterm>
21282128
The privileges that have been granted for a particular object are
2129-
displayed as a list of <type>aclitem</type> entries, where each
2130-
<type>aclitem</type> describes the permissions of one grantee that
2131-
have been granted by a particular grantor. For example,
2129+
displayed as a list of <type>aclitem</type> entries, each having the
2130+
format:
2131+
<synopsis>
2132+
<replaceable>grantee</replaceable><literal>=</literal><replaceable>privilege-abbreviation</replaceable><optional><literal>*</literal></optional>...<literal>/</literal><replaceable>grantor</replaceable>
2133+
</synopsis>
2134+
Each <type>aclitem</type> lists all the permissions of one grantee that
2135+
have been granted by a particular grantor. Specific privileges are
2136+
represented by one-letter abbreviations from
2137+
<xref linkend="privilege-abbrevs-table"/>, with <literal>*</literal>
2138+
appended if the privilege was granted with grant option. For example,
21322139
<literal>calvin=r*w/hobbes</literal> specifies that the role
21332140
<literal>calvin</literal> has the privilege
21342141
<literal>SELECT</literal> (<literal>r</literal>) with grant option

0 commit comments

Comments
 (0)