Re: [EXTERNAL] Re: Incomplete sentence in the description for most_common_freqs

From: Nacho Alonso Portillo <Ignacio(dot)Alonso(at)microsoft(dot)com>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: "pgsql-docs(at)lists(dot)postgresql(dot)org" <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: [EXTERNAL] Re: Incomplete sentence in the description for most_common_freqs
Date: 2024-03-13 15:19:52
Message-ID: GV1PR83MB0617CE4F848BAE1E094EAF249B2A2@GV1PR83MB0617.EURPRD83.prod.outlook.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Thanks Tom!

True it is that is perfectly valid English. However, that interpretation might not result trivial to us non-native English speakers.

Would be great if at some point it could be changed to make it clearer.

BTW, it also appears in the definition of the pg_stats_ext_exprs system view.

Regards,
Nacho

________________________________
From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Sent: Wednesday, March 13, 2024 3:37 PM
To: Nacho Alonso Portillo <Ignacio(dot)Alonso(at)microsoft(dot)com>
Cc: pgsql-docs(at)lists(dot)postgresql(dot)org <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: [EXTERNAL] Re: Incomplete sentence in the description for most_common_freqs

[You don't often get email from tgl(at)sss(dot)pgh(dot)pa(dot)us(dot) Learn why this is important at https://aka.ms/LearnAboutSenderIdentification ]

PG Doc comments form <noreply(at)postgresql(dot)org> writes:
> It seems the ending clarifying sentence:
> "(Null when most_common_vals is.)"
> should rather be:
> "(Null when most_common_vals is null.)"

I think it's perfectly good English as-is, if a bit terse.

regards, tom lane

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Nacho Alonso Portillo 2024-03-13 15:21:39 Re: [EXTERNAL] Re: Definition of random_page_cost seems to invert correlation of that setting and seq_page_cost
Previous Message Tom Lane 2024-03-13 14:37:39 Re: Incomplete sentence in the description for most_common_freqs