From: | Alvaro Herrera <alvherre(at)2ndquadrant(dot)com> |
---|---|
To: | hzlopes(at)gmail(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org |
Subject: | Re: Wrong formatting of the word 'executed' |
Date: | 2019-07-25 17:03:56 |
Message-ID: | 20190725170356.GA14993@alvherre.pgsql |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
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
From | Date | Subject | |
---|---|---|---|
Next Message | PG Doc comments form | 2019-07-26 17:07:40 | Improvements regarding explanation of parallel execution and detailed node parameters |
Previous Message | Tom Lane | 2019-07-25 16:20:01 | Re: Missing preposition 'of' |