Use the correct article for abbreviations
authorDavid Rowley <drowley@postgresql.org>
Fri, 11 Jun 2021 01:38:04 +0000 (13:38 +1200)
committerDavid Rowley <drowley@postgresql.org>
Fri, 11 Jun 2021 01:38:04 +0000 (13:38 +1200)
commit04539e73faaaaa1c06c1407671910dceaffdfcd4
tree1b08939c5e2532089345aa5acb50bcc187472195
parente56bce5d43789cce95d099554ae9593ada92b3b7
Use the correct article for abbreviations

We've accumulated quite a mix of instances of "an SQL" and "a SQL" in the
documents.  It would be good to be a bit more consistent with these.

The most recent version of the SQL standard I looked at seems to prefer
"an SQL".  That seems like a good lead to follow, so here we change all
instances of "a SQL" to become "an SQL".  Most instances correctly use
"an SQL" already, so it also makes sense to use the dominant variation in
order to minimise churn.

Additionally, there were some other abbreviations that needed to be
adjusted. FSM, SSPI, SRF and a few others.  Also fix some pronounceable,
abbreviations to use "a" instead of "an".  For example, "a SASL" instead
of "an SASL".

Here I've only adjusted the documents and error messages.  Many others
still exist in source code comments.  Translator hint comments seem to be
the biggest culprit.  It currently does not seem worth the churn to change
these.

Discussion: https://postgr.es/m/CAApHDvpML27UqFXnrYO1MJddsKVMQoiZisPvsAGhKE_tsKXquw%40mail.gmail.com
35 files changed:
doc/src/sgml/client-auth.sgml
doc/src/sgml/config.sgml
doc/src/sgml/datatype.sgml
doc/src/sgml/dblink.sgml
doc/src/sgml/ecpg.sgml
doc/src/sgml/extend.sgml
doc/src/sgml/func.sgml
doc/src/sgml/high-availability.sgml
doc/src/sgml/indexam.sgml
doc/src/sgml/libpq.sgml
doc/src/sgml/ltree.sgml
doc/src/sgml/mvcc.sgml
doc/src/sgml/pageinspect.sgml
doc/src/sgml/pgcrypto.sgml
doc/src/sgml/plpgsql.sgml
doc/src/sgml/plpython.sgml
doc/src/sgml/pltcl.sgml
doc/src/sgml/protocol.sgml
doc/src/sgml/ref/alter_opfamily.sgml
doc/src/sgml/ref/create_function.sgml
doc/src/sgml/ref/create_opclass.sgml
doc/src/sgml/ref/create_statistics.sgml
doc/src/sgml/ref/create_trigger.sgml
doc/src/sgml/ref/pg_dump.sgml
doc/src/sgml/ref/pgbench.sgml
doc/src/sgml/ref/psql-ref.sgml
doc/src/sgml/tablefunc.sgml
doc/src/sgml/tablesample-method.sgml
doc/src/sgml/textsearch.sgml
doc/src/sgml/trigger.sgml
doc/src/sgml/typeconv.sgml
doc/src/sgml/xfunc.sgml
src/backend/executor/functions.c
src/bin/pgbench/pgbench.c
src/bin/pgbench/t/001_pgbench_with_server.pl