Use the correct article for abbreviations

Enterprise / PostgreSQL - David Rowley [postgresql.org] - 11 June 2021 01:38 UTC

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

04539e73fa Use the correct article for abbreviations
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(-)

Upstream: git.postgresql.org


  • Share