AM was used throughout the documentation to denote Access Method, but
the acronym was not described. This adds an acronym entry as well as
a glossary term which the acronym links to. Each page which describe
AMs have the first occurrence with <acronym> markup.
Reported-by: alaa.attya91@gmail.com
Reviewed-by: Alvaro Herrera <alvherre@alvh.no-ip.org>
Discussion: https://postgr.es/m/
169974408805.398198.
6927340566912872957@wrigleys.postgresql.org
index 22e0dc5c70b559896565b17bdef41efd5ee5e8ac..817d062c7e6eb1b5cb9d15f333788433a1b332cc 100644 (file)
<variablelist>
+ <varlistentry>
+ <term><acronym>AM</acronym></term>
+ <listitem>
+ <para>
+ <link linkend="glossary-am">Access Method</link>
+ </para>
+ </listitem>
+ </varlistentry>
+
<varlistentry>
<term><acronym>ANSI</acronym></term>
<listitem>
index 6f608a14bf318834080e954a2acb30e9abb6533d..be8210286b63220576c72cca8e3ad60ea99fa3f5 100644 (file)
and understanding of sorting semantics. Therefore, they've acquired
some features that go beyond what would be needed just to support btree
indexes, and parts of the system that are quite distant from the
- btree AM make use of them.
+ btree <acronym>AM</acronym> make use of them.
</para>
</sect1>
index ccd480aede014baec1353ca94c042429306a48f7..8c2f11480d37be1f75f327de234cad54e0aef6ce 100644 (file)
</glossdef>
</glossentry>
+ <glossentry id="glossary-am">
+ <glossterm>Access Method</glossterm>
+ <glossdef>
+ <para>
+ Interfaces which <productname>PostgreSQL</productname> use in order to
+ access data in tables and indexes. This abstraction allows for adding
+ support for new types of data storage.
+ </para>
+ <para>
+ For more information, see <xref linkend="tableam" /> and
+ <xref linkend="indexam" />.
+ </para>
+ </glossdef>
+ </glossentry>
+
<glossentry>
<glossterm>Analytic function</glossterm>
<glosssee otherterm="glossary-window-function" />
index cc4135e3940f85873c60456b9857d8f3cbfb609d..b68daa55aeb726239809f2a39b93d8da7f0ad3f0 100644 (file)
the first; however they are permitted to require some restriction to
appear for the first index column, and this is signaled by setting
<structfield>amoptionalkey</structfield> false.
- One reason that an index AM might set
+ One reason that an index <acronym>AM</acronym> might set
<structfield>amoptionalkey</structfield> false is if it doesn't index
null values. Since most indexable operators are
strict and hence cannot return true for null inputs,
index 6a6eb2b766540032a6ea34be604e2003195edd1c..4b37f2e5a601c47b963c93014710fb4e6467607c 100644 (file)
<para>
To implement an access method, an implementor will typically need to
- implement an AM-specific type of tuple table slot (see
+ implement an <acronym>AM</acronym>-specific type of tuple table slot (see
<ulink url="https://git.postgresql.org/gitweb/?p=postgresql.git;a=blob;f=src/include/executor/tuptable.h;hb=HEAD">
<filename>src/include/executor/tuptable.h</filename></ulink>), which allows
code outside the access method to hold references to tuples of the AM, and