doc: Add ACL acronym for "Access Control List"

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

View File

@ -9,6 +9,15 @@
<variablelist> <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> <varlistentry>
<term><acronym>AM</acronym></term> <term><acronym>AM</acronym></term>
<listitem> <listitem>

View File

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

View File

@ -1819,7 +1819,7 @@ ALTER TABLE products RENAME TO items;
</indexterm> </indexterm>
<indexterm zone="ddl-priv"> <indexterm zone="ddl-priv">
<primary>ACL</primary> <primary><acronym>ACL</acronym></primary>
</indexterm> </indexterm>
<indexterm zone="ddl-priv-default"> <indexterm zone="ddl-priv-default">
@ -2183,13 +2183,14 @@ REVOKE ALL ON accounts FROM PUBLIC;
<para> <para>
<xref linkend="privilege-abbrevs-table"/> shows the one-letter <xref linkend="privilege-abbrevs-table"/> shows the one-letter
abbreviations that are used for these privilege types in 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"/> 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> </para>
<table id="privilege-abbrevs-table"> <table id="privilege-abbrevs-table">
<title>ACL Privilege Abbreviations</title> <title><acronym>ACL</acronym> Privilege Abbreviations</title>
<tgroup cols="3"> <tgroup cols="3">
<colspec colname="col1" colwidth="1*"/> <colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="1*"/> <colspec colname="col2" colwidth="1*"/>

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 Constructs an <type>aclitem</type> array holding the default access
privileges for an object of type <parameter>type</parameter> belonging privileges for an object of type <parameter>type</parameter> belonging
to the role with OID <parameter>ownerId</parameter>. This represents to the role with OID <parameter>ownerId</parameter>. This represents
the access privileges that will be assumed when an object's ACL entry the access privileges that will be assumed when an object's
is null. (The default access privileges are described in <acronym>ACL</acronym> entry is null. (The default access privileges
<xref linkend="ddl-priv"/>.) are described in <xref linkend="ddl-priv"/>.)
The <parameter>type</parameter> parameter must be one of The <parameter>type</parameter> parameter must be one of
'c' for <literal>COLUMN</literal>, 'c' for <literal>COLUMN</literal>,
'r' for <literal>TABLE</literal> and table-like objects, 'r' for <literal>TABLE</literal> and table-like objects,