From: Tom Lane Date: Fri, 22 Sep 2023 18:52:36 +0000 (-0400) Subject: Doc: copy-edit the introductory para for the pg_class catalog. X-Git-Tag: REL_11_22~59 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=2a47c04535286f2a43bbc4a1694d5efb884a8220;p=thirdparty%2Fpostgresql.git Doc: copy-edit the introductory para for the pg_class catalog. The previous wording had a faint archaic whiff to it, and more importantly used "catalogs" as a verb, which while cutely self-referential seems likely to provoke confusion in this particular context. Also consistently use "kind" not "type" to refer to the different kinds of relations distinguished by relkind. Per gripe from Martin Nash. Back-patch to supported versions. Discussion: https://postgr.es/m/169518739902.3727338.4793815593763320945@wrigleys.postgresql.org --- diff --git a/doc/src/sgml/catalogs.sgml b/doc/src/sgml/catalogs.sgml index 607645c4bac..bd622680d23 100644 --- a/doc/src/sgml/catalogs.sgml +++ b/doc/src/sgml/catalogs.sgml @@ -1646,15 +1646,15 @@ SCRAM-SHA-256$<iteration count>:&l - The catalog pg_class catalogs tables and most - everything else that has columns or is otherwise similar to a + The catalog pg_class describes tables and + other objects that have columns or are otherwise similar to a table. This includes indexes (but see also pg_index), sequences (but see also pg_sequence), views, materialized views, composite types, and TOAST tables; see relkind. - Below, when we mean all of these - kinds of objects we speak of relations. Not all - columns are meaningful for all relation types. + Below, when we mean all of these kinds of objects we speak of + relations. Not all of pg_class's + columns are meaningful for all relation kinds.