Re: Cleanup of syntax.sgml - Mailing list pgsql-docs

From David G. Johnston
Subject Re: Cleanup of syntax.sgml
Date
Msg-id CAKFQuwbbsk9BSs_7+C3mvrROBrBASkMwOZXEkbppoapJHKeDGw@mail.gmail.com
Whole thread Raw
In response to Re: Cleanup of syntax.sgml  (Joshua Drake <jd@commandprompt.com>)
List pgsql-docs
On Fri, Jun 20, 2025 at 2:21 PM Joshua Drake <jd@commandprompt.com> wrote:
 
"We advise users who to read this chapter carefully  ..." ? botched surgery on this one

Not sure what you mean here? I reviewed the source sgml (that I modified):

We advise users who to read this chapter carefully because it  
 contains several rules and concepts that are implemented  
 inconsistently among SQL databases or that are specific to  
 <productname>PostgreSQL</productname>.

We advise users who to read this chapter carefully... is not proper English - drop the "who"?

We advise users to read this chapter carefully

Honestly, though, that is just bad advice.  It is not possible to read it carefully, it's too much material.  Apply ruthless subjective-ness removal protocol here too.  Just state what the chapter covers.

David J.

pgsql-docs by date:

Previous
From: Joshua Drake
Date:
Subject: Re: Cleanup of syntax.sgml
Next
From: Masahiko Sawada
Date:
Subject: Re: Fix incorrect UUID index entry in function documentation