Doc: copy-edit the introductory para for the pg_class catalog.
authorTom Lane
Fri, 22 Sep 2023 18:52:36 +0000 (14:52 -0400)
committerTom Lane
Fri, 22 Sep 2023 18:52:36 +0000 (14:52 -0400)
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

doc/src/sgml/catalogs.sgml

index 37c6a2bb73652c5d0340051a88a096c3d1c493ef..43cccb43d62094b7e94f044a6f0cf4f8d5e5e5be 100644 (file)
@@ -1892,8 +1892,8 @@ 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 
    linkend="catalog-pg-index">pg_index),
    sequences (but see also 
@@ -1901,8 +1901,8 @@ SCRAM-SHA-256$<iteration count>:&l
    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.
+   relations.  Not all of pg_class's
+   columns are meaningful for all relation kinds.