From: Tom Lane <tgl@sss.pgh.pa.us>
To: David G. Johnston <david.g.johnston@gmail.com>
Cc: Eugen Konkov <konkove@gmail.com>
Cc: pgsql-docs@lists.postgresql.org <pgsql-docs@lists.postgresql.org>
Subject: Re: Documentation does not describes format for access privileges: =Tc/user
Date: Mon, 25 Dec 2023 13:31:11 -0500
Message-ID: <1887860.1703529071@sss.pgh.pa.us> (raw)
In-Reply-To: <CAKFQuwbRk15AthfdkzZ9xDS0E+QvXG07Btcvv8V6DUg9jJdz2g@mail.gmail.com>
References: <170326116972.1876499.18357820037829248593@wrigleys.postgresql.org>
<CAKFQuwYrHMBJCDTUGHRBhhZtvpgvDyR_G8yRtWqLuFA31QYYig@mail.gmail.com>
<CAAwmOLxHUERXUyOpgbb1-7x0Yo_+r8fVQpVeQ84pG9wGEKtUwQ@mail.gmail.com>
<CAKFQuwYtgkkGr0nx_vn255hXxdBnoV=_9expMk+KHxooP=9oZA@mail.gmail.com>
<CAKFQuwbRk15AthfdkzZ9xDS0E+QvXG07Btcvv8V6DUg9jJdz2g@mail.gmail.com>
"David G. Johnston" <david.g.johnston@gmail.com> writes:
> We probably should write the syntax like we do everywhere else:
> [grantee]={privilege[*]}[…]/grantor
> Then define the placeholders in the subsequent paragraph.
Seems reasonable. About like this?
regards, tom lane
Attachments:
[text/x-diff] doc-aclitem-format-explicitly.patch (1000B, ../1887860.1703529071@sss.pgh.pa.us/2-doc-aclitem-format-explicitly.patch)
download | inline diff:diff --git a/doc/src/sgml/ddl.sgml b/doc/src/sgml/ddl.sgmlindex d2951cd754..664361a724 100644--- a/doc/src/sgml/ddl.sgml+++ b/doc/src/sgml/ddl.sgml@@ -2318,8 +2318,12 @@ 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+ displayed as a list of <type>aclitem</type> entries, each having the+ format:+<synopsis>+<replaceable>grantee</replaceable><literal>=</literal><replaceable>privilege-abbreviations</replaceable><literal>/</literal><replaceable>grantor</replaceable>+</synopsis>+ Each <type>aclitem</type> describes the permissions of one grantee that
have been granted by a particular grantor. For example,
<literal>calvin=r*w/hobbes</literal> specifies that the role
<literal>calvin</literal> has the privilege
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: tgl@sss.pgh.pa.us, david.g.johnston@gmail.com, konkove@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: Documentation does not describes format for access privileges: =Tc/user
In-Reply-To: <1887860.1703529071@sss.pgh.pa.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox