From bbb9bec11c58c8c6401abf696c43626028edeb6a Mon Sep 17 00:00:00 2001
From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Fri, 22 Sep 2023 14:52:36 -0400
Subject: [PATCH] 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
---
doc/src/sgml/catalogs.sgml | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
diff --git a/doc/src/sgml/catalogs.sgml b/doc/src/sgml/catalogs.sgml
index 0f58cb102de..7be2d317295 100644
--- a/doc/src/sgml/catalogs.sgml
+++ b/doc/src/sgml/catalogs.sgml
@@ -1852,8 +1852,8 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l
</indexterm>
<para>
- The catalog <structname>pg_class</structname> catalogs tables and most
- everything else that has columns or is otherwise similar to a
+ The catalog <structname>pg_class</structname> describes tables and
+ other objects that have columns or are otherwise similar to a
table. This includes indexes (but see also <link
linkend="catalog-pg-index"><structname>pg_index</structname></link>),
sequences (but see also <link
@@ -1861,8 +1861,8 @@ SCRAM-SHA-256$<replaceable><iteration count></replaceable>:<replaceable>&l
views, materialized views, composite types, and TOAST tables;
see <structfield>relkind</structfield>.
Below, when we mean all of these kinds of objects we speak of
- <quote>relations</quote>. Not all columns are meaningful for all relation
- types.
+ <quote>relations</quote>. Not all of <structname>pg_class</structname>'s
+ columns are meaningful for all relation kinds.
</para>
<table>
--
2.39.5