From: Alvaro Herrera <alvherre@2ndquadrant.com>
To: hzlopes@gmail.com
To: pgsql-docs@lists.postgresql.org
Subject: Re: Wrong formatting of the word 'executed'
Date: Thu, 25 Jul 2019 13:03:56 -0400
Message-ID: <20190725170356.GA14993@alvherre.pgsql> (raw)
In-Reply-To: <156405789146.1190.11864810353757307019@wrigleys.postgresql.org>
On 2019-Jul-25, PG Doc comments form wrote:
> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/11/plpgsql-expressions.html
> Description:
>
> In section 43.4, in the sentence "(...) and then this prepared statement is
> EXECUTEd (...)", the word executed should be modified to lower case.
ISTM that this is intentional, since it refers to the use of the EXECUTE
command. It does seem maybe too informal to use command names as verbs
and conjugate them ... we don't do it too much, except for "TOASTed".
$ git grep '</[a-z_]*>e\?d'
doc/src/sgml/gist.sgml: function should return a pointer to newly <function>palloc()</function>ed
doc/src/sgml/lobj.sgml: up to 4 TB in size, whereas <acronym>TOAST</acronym>ed fields can be at
doc/src/sgml/lobj.sgml: done efficiently, while most operations on a <acronym>TOAST</acronym>ed
doc/src/sgml/plpgsql.sgml: and then this prepared statement is <command>EXECUTE</command>d for each
doc/src/sgml/storage.sgml:called <firstterm><acronym>TOAST</acronym>ed values</firstterm> work by modifying or
doc/src/sgml/storage.sgml:handle potentially <acronym>TOAST</acronym>ed input values: an input might not
doc/src/sgml/storage.sgml:the value is an ordinary un-<acronym>TOAST</acronym>ed value of the data type, and
doc/src/sgml/storage.sgml:<acronym>TOAST</acronym>ed values are kept in the <acronym>TOAST</acronym> table, as
doc/src/sgml/storage.sgml:identifying the particular <acronym>TOAST</acronym>ed value),
doc/src/sgml/storage.sgml:<acronym>TOAST</acronym>ed value therefore needs to store the OID of the
doc/src/sgml/storage.sgml:of <acronym>TOAST</acronym>ed attributes will only be pulled out (if selected at all)
doc/src/sgml/storage.sgml:pages). There was no run time difference compared to an un-<acronym>TOAST</acronym>ed
We do append "s" to make plurals a lot, though.
--
Álvaro Herrera https://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: alvherre@2ndquadrant.com, hzlopes@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: Wrong formatting of the word 'executed'
In-Reply-To: <20190725170356.GA14993@alvherre.pgsql>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox