Re: Wrong formatting of the word 'executed' - Mailing list pgsql-docs

From Alvaro Herrera
Subject Re: Wrong formatting of the word 'executed'
Date
Msg-id 20190725170356.GA14993@alvherre.pgsql
Whole thread Raw
In response to Wrong formatting of the word 'executed'  (PG Doc comments form <noreply@postgresql.org>)
List 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



pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: Missing preposition 'of'
Next
From: PG Doc comments form
Date:
Subject: Improvements regarding explanation of parallel execution and detailed node parameters