pgsql: Use the correct article for abbreviations

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
|

pgsql: Use the correct article for abbreviations

David Rowley-4
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

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/04539e73faaaaa1c06c1407671910dceaffdfcd4

Modified Files
--------------
doc/src/sgml/client-auth.sgml                |  2 +-
doc/src/sgml/config.sgml                     |  6 +++---
doc/src/sgml/datatype.sgml                   |  2 +-
doc/src/sgml/dblink.sgml                     | 10 +++++-----
doc/src/sgml/ecpg.sgml                       | 14 +++++++-------
doc/src/sgml/extend.sgml                     |  2 +-
doc/src/sgml/func.sgml                       |  8 ++++----
doc/src/sgml/high-availability.sgml          |  2 +-
doc/src/sgml/indexam.sgml                    |  2 +-
doc/src/sgml/libpq.sgml                      |  4 ++--
doc/src/sgml/ltree.sgml                      |  2 +-
doc/src/sgml/mvcc.sgml                       |  2 +-
doc/src/sgml/pageinspect.sgml                |  2 +-
doc/src/sgml/pgcrypto.sgml                   |  2 +-
doc/src/sgml/plpgsql.sgml                    | 14 +++++++-------
doc/src/sgml/plpython.sgml                   |  4 ++--
doc/src/sgml/pltcl.sgml                      |  6 +++---
doc/src/sgml/protocol.sgml                   |  6 +++---
doc/src/sgml/ref/alter_opfamily.sgml         |  2 +-
doc/src/sgml/ref/create_function.sgml        |  2 +-
doc/src/sgml/ref/create_opclass.sgml         |  2 +-
doc/src/sgml/ref/create_statistics.sgml      |  2 +-
doc/src/sgml/ref/create_trigger.sgml         |  2 +-
doc/src/sgml/ref/pg_dump.sgml                |  2 +-
doc/src/sgml/ref/pgbench.sgml                |  4 ++--
doc/src/sgml/ref/psql-ref.sgml               |  6 +++---
doc/src/sgml/tablefunc.sgml                  |  8 ++++----
doc/src/sgml/tablesample-method.sgml         |  2 +-
doc/src/sgml/textsearch.sgml                 |  2 +-
doc/src/sgml/trigger.sgml                    |  2 +-
doc/src/sgml/typeconv.sgml                   |  2 +-
doc/src/sgml/xfunc.sgml                      | 20 ++++++++++----------
src/backend/executor/functions.c             |  4 ++--
src/bin/pgbench/pgbench.c                    |  4 ++--
src/bin/pgbench/t/001_pgbench_with_server.pl |  6 +++---
35 files changed, 81 insertions(+), 81 deletions(-)