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

Commit d02cceb

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 e87252c commit d02cceb

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
@@ -2280,9 +2280,16 @@ REVOKE ALL ON accounts FROM PUBLIC;
22802280
<primary><type>aclitem</type></primary>
22812281
</indexterm>
22822282
The privileges that have been granted for a particular object are
2283-
displayed as a list of <type>aclitem</type> entries, where each
2284-
<type>aclitem</type> describes the permissions of one grantee that
2285-
have been granted by a particular grantor. For example,
2283+
displayed as a list of <type>aclitem</type> entries, each having the
2284+
format:
2285+
<synopsis>
2286+
<replaceable>grantee</replaceable><literal>=</literal><replaceable>privilege-abbreviation</replaceable><optional><literal>*</literal></optional>...<literal>/</literal><replaceable>grantor</replaceable>
2287+
</synopsis>
2288+
Each <type>aclitem</type> lists all the permissions of one grantee that
2289+
have been granted by a particular grantor. Specific privileges are
2290+
represented by one-letter abbreviations from
2291+
<xref linkend="privilege-abbrevs-table"/>, with <literal>*</literal>
2292+
appended if the privilege was granted with grant option. For example,
22862293
<literal>calvin=r*w/hobbes</literal> specifies that the role
22872294
<literal>calvin</literal> has the privilege
22882295
<literal>SELECT</literal> (<literal>r</literal>) with grant option

0 commit comments

Comments
 (0)