From: Tom Lane <tgl@sss.pgh.pa.us>
To: Daniel Gustafsson <daniel@yesql.se>
Cc: mpnash@google.com
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: Typo/wording on https://www.postgresql.org/docs/current/catalog-pg-class.html
Date: Wed, 20 Sep 2023 09:49:10 -0400
Message-ID: <520464.1695217750@sss.pgh.pa.us> (raw)
In-Reply-To: <A4F03320-8592-4BF6-8C22-B81CF681BD96@yesql.se>
References: <169518739902.3727338.4793815593763320945@wrigleys.postgresql.org>
<A4F03320-8592-4BF6-8C22-B81CF681BD96@yesql.se>
Daniel Gustafsson <daniel@yesql.se> writes:
>> On 20 Sep 2023, at 07:23, PG Doc comments form <noreply@postgresql.org> wrote:
>> I've just read this:
>> "catalogs tables and most everything else that has columns or is otherwise
>> similar to a table"
>> It seems that it should be:
>> "catalogs tables and almost everything else that has columns or is otherwise
>> similar to a table"
> While I'm not a native english speaker I do believe this wording is correct
> (although I guess your version would be semantically the same or very close to
> it). It was done in commit 83501ef4ca some 20+ years ago.
"Most" here is good English, although I concede it's a slightly
old-fashioned usage. Maybe it'd be clearer to just remove the
word altogether.
If we were going to touch this sentence I'd worry about some other
things too. Use of "catalogs" as a verb is probably not the greatest
choice right here, since one could easily think that the verb is
missing and what was meant was "pg_class lists catalogs, [user]
tables, and ...". Also, I think that the reference to special
relations is obsolete --- we don't list any relkind for that anymore.
What probably does deserve to be called out in place of those is
composite types, since their appearance in pg_class might be pretty
surprising to newbies.
regards, tom lane
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: tgl@sss.pgh.pa.us, daniel@yesql.se, mpnash@google.com, pgsql-docs@lists.postgresql.org
Subject: Re: Typo/wording on https://www.postgresql.org/docs/current/catalog-pg-class.html
In-Reply-To: <520464.1695217750@sss.pgh.pa.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox