Commit456b6b6

committed

Doc: specify aclitem syntax more clearly.

The previous wording here relied solely on an example to explainaclitem output format. Add an actual syntax synopsis andexplanation 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 parentea61b1c commit456b6b6Copy full SHA for 456b6b6

File tree

+10

-3

lines changed

+10

-3

lines changed

Lines changed: 10 additions & 3 deletions

Original file line number	Diff line number	Diff line change
`@@ -2126,9 +2126,16 @@ REVOKE ALL ON accounts FROM PUBLIC;`
`2126`	`2126`	`<primary><type>aclitem</type></primary>`
`2127`	`2127`	`</indexterm>`
`2128`	`2128`	`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,`
`2132`	`2139`	`<literal>calvin=r*w/hobbes</literal> specifies that the role`
`2133`	`2140`	`<literal>calvin</literal> has the privilege`
`2134`	`2141`	`<literal>SELECT</literal> (<literal>r</literal>) with grant option`

Comments

(0)