pgsql: Use the correct article for abbreviations

Поиск
Список
Период
Сортировка
От David Rowley
Тема pgsql: Use the correct article for abbreviations
Дата
Msg-id E1lrW7w-0000YW-P2@gemulon.postgresql.org
обсуждение исходный текст
Список pgsql-committers
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(-)


В списке pgsql-committers по дате отправления:

Предыдущее
От: Tom Lane
Дата:
Сообщение: pgsql: Reconsider the handling of procedure OUT parameters.
Следующее
От: Noah Misch
Дата:
Сообщение: pgsql: Change position of field "transformed" in struct CreateStatsStmt