doc: Add ACL acronym for "Access Control List"

michaelpq · michaelpq · commit 00d819d46a6f · 2024-07-01T09:55:37.000+09:00
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
diff --git a/doc/src/sgml/acronyms.sgml b/doc/src/sgml/acronyms.sgml
@@ -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>
diff --git a/doc/src/sgml/catalogs.sgml b/doc/src/sgml/catalogs.sgml
@@ -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.)
diff --git a/doc/src/sgml/ddl.sgml b/doc/src/sgml/ddl.sgml
@@ -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*"/>
diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
@@ -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,
