mirrors/postgres
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

doc: Add ACL acronym for "Access Control List"

Browse Source 
Five places across the docs use this abbreviation, so let's use a proper
acronym entry for it.

Per suggestion from me.

Author: Joel Jacobson
Reviewed-by: Nathan Bossart, David G. Johnston
Discussion: https://postgr.es/m/9253b872-dbb1-42a6-a79e-b1e96effc857@app.fastmail.com
This commit is contained in:
Michael Paquier 2024-07-01 09:55:37 +09:00
parent b19db55bd6
commit 00d819d46a
4 changed files with 20 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
doc/src/sgml/acronyms.sgml
View File

@ -9,6 +9,15 @@
<variablelist>
<varlistentry>
<term><acronym>ACL</acronym></term>
<listitem>
<para>
<ulink url="https://en.wikipedia.org/wiki/Access-control_list">Access Control List</ulink>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><acronym>AM</acronym></term>
<listitem>

6
doc/src/sgml/catalogs.sgml
View File

@ -3349,8 +3349,8 @@ SCRAM-SHA-256$<replaceable>&lt;iteration count&gt;</replaceable>:<replaceable>&l
</para>
<para>
Note that when an ACL entry in another catalog is null, it is taken
to represent the hard-wired default privileges for its object,
Note that when an <acronym>ACL</acronym> entry in another catalog is null,
it is taken to represent the hard-wired default privileges for its object,
<emphasis>not</emphasis> whatever might be in <structname>pg_default_acl</structname>
at the moment. <structname>pg_default_acl</structname> is only consulted during
object creation.
@ -7167,7 +7167,7 @@ SCRAM-SHA-256$<replaceable>&lt;iteration count&gt;</replaceable>:<replaceable>&l
<listitem>
<para>
The referenced object (which must be a role) is mentioned in the
ACL (access control list, i.e., privileges list) of the
<acronym>ACL</acronym> of the
dependent object. (A <symbol>SHARED_DEPENDENCY_ACL</symbol> entry is
not made for the owner of the object, since the owner will have
a <symbol>SHARED_DEPENDENCY_OWNER</symbol> entry anyway.)

9
doc/src/sgml/ddl.sgml
View File

@ -1819,7 +1819,7 @@ ALTER TABLE products RENAME TO items;
</indexterm>
<indexterm zone="ddl-priv">
<primary>ACL</primary>
<primary><acronym>ACL</acronym></primary>
</indexterm>
<indexterm zone="ddl-priv-default">
@ -2183,13 +2183,14 @@ REVOKE ALL ON accounts FROM PUBLIC;
<para>
<xref linkend="privilege-abbrevs-table"/> shows the one-letter
abbreviations that are used for these privilege types in
<firstterm>ACL</firstterm> (Access Control List) values.
<firstterm><acronym>ACL</acronym></firstterm> values.
You will see these letters in the output of the <xref linkend="app-psql"/>
commands listed below, or when looking at ACL columns of system catalogs.
commands listed below, or when looking at <acronym>ACL</acronym> columns
of system catalogs.
</para>
<table id="privilege-abbrevs-table">
<title>ACL Privilege Abbreviations</title>
<title><acronym>ACL</acronym> Privilege Abbreviations</title>
<tgroup cols="3">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="1*"/>

6
doc/src/sgml/func.sgml
View File

@ -25286,9 +25286,9 @@ SELECT has_function_privilege('joeuser', 'myfunc(int, text)', 'execute');
Constructs an <type>aclitem</type> array holding the default access
privileges for an object of type <parameter>type</parameter> belonging
to the role with OID <parameter>ownerId</parameter>. This represents
the access privileges that will be assumed when an object's ACL entry
is null. (The default access privileges are described in
<xref linkend="ddl-priv"/>.)
the access privileges that will be assumed when an object's
<acronym>ACL</acronym> entry is null. (The default access privileges
are described in <xref linkend="ddl-priv"/>.)
The <parameter>type</parameter> parameter must be one of
'c' for <literal>COLUMN</literal>,
'r' for <literal>TABLE</literal> and table-like objects,