Re: [doc] minor wording improvement in a couple of places - Mailing list pgsql-hackers

From Magnus Hagander
Subject Re: [doc] minor wording improvement in a couple of places
Date
Msg-id CABUevEw+Jj3O4LgqBzvG-XmV59pg5ARLrufJO0Fz9LAQJXMefg@mail.gmail.com
Whole thread Raw
In response to [doc] minor wording improvement in a couple of places  (Ian Barwick <ian.barwick@2ndquadrant.com>)
Responses Re: [doc] minor wording improvement in a couple of places  (John Naylor <john.naylor@2ndquadrant.com>)
List pgsql-hackers
On Mon, Sep 7, 2020 at 6:34 AM Ian Barwick <ian.barwick@2ndquadrant.com> wrote:
Hi

On these pages:

   https://www.postgresql.org/docs/current/fdw-callbacks.html
   https://www.postgresql.org/docs/current/tablesample-method.html

we have the phrase:

   "..., which see for additional details."

which strikes me as a bit odd. Suggested phrasing:

   "...; see this file for additional details."


I agree this sounds very weird. However, this phrasing is also fairly common in comments around the code.

I was first guessing that this came out of one of us non-english native speakers, but AFAICT it's a mix of authors and definitely including those natively speaking the language. 

I would still suggest that we change it, because it does sound odd to me as well, but I'll defer a bit and see if others might think we should keep it. 


--

pgsql-hackers by date:

Previous
From: Asif Rehman
Date:
Subject: Re: Allow CURRENT_ROLE in GRANTED BY
Next
From: "Andrey V. Lepikhov"
Date:
Subject: Re: [POC] Fast COPY FROM command for the table with foreign partitions