Re: [doc] minor wording improvement in a couple of places

Поиск
Список
Период
Сортировка
От Magnus Hagander
Тема Re: [doc] minor wording improvement in a couple of places
Дата
Msg-id CABUevEw+Jj3O4LgqBzvG-XmV59pg5ARLrufJO0Fz9LAQJXMefg@mail.gmail.com
обсуждение исходный текст
Ответ на [doc] minor wording improvement in a couple of places  (Ian Barwick <ian.barwick@2ndquadrant.com>)
Ответы Re: [doc] minor wording improvement in a couple of places
Список 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 по дате отправления:

Предыдущее
От: Asif Rehman
Дата:
Сообщение: Re: Allow CURRENT_ROLE in GRANTED BY
Следующее
От: "Andrey V. Lepikhov"
Дата:
Сообщение: Re: [POC] Fast COPY FROM command for the table with foreign partitions