Improve consistency of comments in system catalog headers.

Use the term "system catalog" rather than "system relation" in assorted
places where it's clearly referring to a table rather than, say, an
index.  Use more natural word order in the header boilerplate, improve
some of the one-liner catalog descriptions, and fix assorted random
deviations from the normal boilerplate.  All purely neatnik-ism, but
why not.

John Naylor, some additional cleanup by me

Discussion: https://postgr.es/m/CAJVSVGUeJmFB3h-NJ18P32NPa+kzC165nm7GSoGHfPaN80Wxcw@mail.gmail.com

src/backend/catalog/genbki.pl

@@ -535,8 +535,8 @@ sub gen_pg_attribute
 	{
 		my $table = $catalogs{$table_name};
 
-		# Currently, all bootstrapped relations also need schemapg.h
-		# entries, so skip if the relation isn't to be in schemapg.h.
+		# Currently, all bootstrap catalogs also need schemapg.h
+		# entries, so skip if it isn't to be in schemapg.h.
 		next if !$table->{schema_macro};
 
 		$schemapg_entries{$table_name} = [];
@@ -769,7 +769,7 @@ sub form_pg_type_symbol
 {
 	my $typename = shift;
 
-	# Skip for rowtypes of bootstrap tables, since they have their
+	# Skip for rowtypes of bootstrap catalogs, since they have their
 	# own naming convention defined elsewhere.
 	return
 	  if $typename eq 'pg_type'

src/include/catalog/pg_aggregate.dat

 #----------------------------------------------------------------------
 #
 # pg_aggregate.dat
-#    Initial contents of the pg_aggregate system relation.
+#    Initial contents of the pg_aggregate system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_aggregate.h

 /*-------------------------------------------------------------------------
  *
  * pg_aggregate.h
- *	  definition of the system "aggregate" relation (pg_aggregate)
+ *	  definition of the "aggregate" system catalog (pg_aggregate)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_am.dat

 #----------------------------------------------------------------------
 #
 # pg_am.dat
-#    Initial contents of the pg_am system relation.
+#    Initial contents of the pg_am system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_am.h

 /*-------------------------------------------------------------------------
  *
  * pg_am.h
- *	  definition of the system "access method" relation (pg_am)
+ *	  definition of the "access method" system catalog (pg_am)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_amop.dat

 #----------------------------------------------------------------------
 #
 # pg_amop.dat
-#    Initial contents of the pg_amop system relation.
+#    Initial contents of the pg_amop system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_amop.h

 /*-------------------------------------------------------------------------
  *
  * pg_amop.h
- *	  definition of the system "amop" relation (pg_amop)
+ *	  definition of the "access method operator" system catalog (pg_amop)
  *
  * The amop table identifies the operators associated with each index operator
  * family and operator class (classes are subsets of families).  An associated

src/include/catalog/pg_amproc.dat

 #----------------------------------------------------------------------
 #
 # pg_amproc.dat
-#    Initial contents of the pg_amproc system relation.
+#    Initial contents of the pg_amproc system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_amproc.h

 /*-------------------------------------------------------------------------
  *
  * pg_amproc.h
- *	  definition of the system "amproc" relation (pg_amproc)
+ *	  definition of the "access method procedure" system catalog (pg_amproc)
  *
  * The amproc table identifies support procedures associated with index
  * operator families and classes.  These procedures can't be listed in pg_amop

src/include/catalog/pg_attrdef.h

 /*-------------------------------------------------------------------------
  *
  * pg_attrdef.h
- *	  definition of the system "attribute defaults" relation (pg_attrdef)
+ *	  definition of the "attribute defaults" system catalog (pg_attrdef)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_attribute.h

 /*-------------------------------------------------------------------------
  *
  * pg_attribute.h
- *	  definition of the system "attribute" relation (pg_attribute)
+ *	  definition of the "attribute" system catalog (pg_attribute)
  *
  * The initial contents of pg_attribute are generated at compile time by
  * genbki.pl, so there is no pg_attribute.dat file.  Only "bootstrapped"

src/include/catalog/pg_auth_members.h

 /*-------------------------------------------------------------------------
  *
  * pg_auth_members.h
- *	  definition of the system "authorization identifier members" relation
+ *	  definition of the "authorization identifier members" system catalog
  *	  (pg_auth_members).
  *
  *

src/include/catalog/pg_authid.dat

 #----------------------------------------------------------------------
 #
 # pg_authid.dat
-#    Initial contents of the pg_authid system relation.
+#    Initial contents of the pg_authid system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_authid.h

 /*-------------------------------------------------------------------------
  *
  * pg_authid.h
- *	  definition of the system "authorization identifier" relation (pg_authid)
+ *	  definition of the "authorization identifier" system catalog (pg_authid)
  *
  *	  pg_shadow and pg_group are now publicly accessible views on pg_authid.
  *

src/include/catalog/pg_cast.dat

 #----------------------------------------------------------------------
 #
 # pg_cast.dat
-#    Initial contents of the pg_cast system relation.
+#    Initial contents of the pg_cast system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_cast.h

 /*-------------------------------------------------------------------------
  *
  * pg_cast.h
- *	  definition of the system "type casts" relation (pg_cast)
+ *	  definition of the "type casts" system catalog (pg_cast)
  *
  * As of Postgres 8.0, pg_cast describes not only type coercion functions
  * but also length coercion functions.
  *
- *
- * Copyright (c) 2002-2018, PostgreSQL Global Development Group
+ * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
+ * Portions Copyright (c) 1994, Regents of the University of California
  *
  * src/include/catalog/pg_cast.h
  *

src/include/catalog/pg_class.dat

 #----------------------------------------------------------------------
 #
 # pg_class.dat
-#    Initial contents of the pg_class system relation.
+#    Initial contents of the pg_class system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California
@@ -12,7 +12,7 @@
 
 [
 
-# Note: only "bootstrapped" relations, ie those marked BKI_BOOTSTRAP, need to
+# Note: only bootstrap catalogs, ie those marked BKI_BOOTSTRAP, need to
 # have entries here.  Be sure that the OIDs listed here match those given in
 # their CATALOG and BKI_ROWTYPE_OID macros, and that the relnatts values are
 # correct.

src/include/catalog/pg_class.h

 /*-------------------------------------------------------------------------
  *
  * pg_class.h
- *	  definition of the system "relation" relation (pg_class)
+ *	  definition of the "relation" system catalog (pg_class)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_collation.dat

 #----------------------------------------------------------------------
 #
 # pg_collation.dat
-#    Initial contents of the pg_collation system relation.
+#    Initial contents of the pg_collation system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_collation.h

 /*-------------------------------------------------------------------------
  *
  * pg_collation.h
- *	  definition of the system "collation" relation (pg_collation)
+ *	  definition of the "collation" system catalog (pg_collation)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
  * Portions Copyright (c) 1994, Regents of the University of California
  *
- * IDENTIFICATION
- *		src/include/catalog/pg_collation.h
+ * src/include/catalog/pg_collation.h
  *
  * NOTES
  *	  The Catalog.pm module reads this file and derives schema

src/include/catalog/pg_constraint.h

 /*-------------------------------------------------------------------------
  *
  * pg_constraint.h
- *	  definition of the system "constraint" relation (pg_constraint)
+ *	  definition of the "constraint" system catalog (pg_constraint)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_conversion.h

 /*-------------------------------------------------------------------------
  *
  * pg_conversion.h
- *	  definition of the system "conversion" relation (pg_conversion)
+ *	  definition of the "conversion" system catalog (pg_conversion)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_database.dat

 #----------------------------------------------------------------------
 #
 # pg_database.dat
-#    Initial contents of the pg_database system relation.
+#    Initial contents of the pg_database system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_database.h

 /*-------------------------------------------------------------------------
  *
  * pg_database.h
- *	  definition of the system "database" relation (pg_database)
+ *	  definition of the "database" system catalog (pg_database)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_db_role_setting.h

 /*-------------------------------------------------------------------------
  *
  * pg_db_role_setting.h
- *	  definition of per-database/per-user configuration settings relation
+ *	  definition of the system catalog for per-database/per-user
+ *	  configuration settings (pg_db_role_setting)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_default_acl.h

 /*-------------------------------------------------------------------------
  *
  * pg_default_acl.h
- *	  definition of default ACLs for new objects.
+ *	  definition of the system catalog for default ACLs of new objects
+ *	  (pg_default_acl)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_depend.h

 /*-------------------------------------------------------------------------
  *
  * pg_depend.h
- *	  definition of the system "dependency" relation (pg_depend)
+ *	  definition of the "dependency" system catalog (pg_depend)
  *
  * pg_depend has no preloaded contents, so there is no pg_depend.dat
  * file; system-defined dependencies are loaded into it during a late stage

src/include/catalog/pg_description.h

 /*-------------------------------------------------------------------------
  *
  * pg_description.h
- *	  definition of the system "description" relation (pg_description)
+ *	  definition of the "description" system catalog (pg_description)
  *
  * Because the contents of this table are taken from the *.dat files
  * of other catalogs, there is no pg_description.dat file. The initial

src/include/catalog/pg_enum.h

 /*-------------------------------------------------------------------------
  *
  * pg_enum.h
- *	  definition of the system "enum" relation (pg_enum)
+ *	  definition of the "enum" system catalog (pg_enum)
  *
  *
- * Copyright (c) 2006-2018, PostgreSQL Global Development Group
+ * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
+ * Portions Copyright (c) 1994, Regents of the University of California
  *
  * src/include/catalog/pg_enum.h
  *

src/include/catalog/pg_event_trigger.h

 /*-------------------------------------------------------------------------
  *
  * pg_event_trigger.h
- *	  definition of the system "event trigger" relation (pg_event_trigger)
+ *	  definition of the "event trigger" system catalog (pg_event_trigger)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_extension.h

 /*-------------------------------------------------------------------------
  *
  * pg_extension.h
- *	  definition of the system "extension" relation (pg_extension)
+ *	  definition of the "extension" system catalog (pg_extension)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_foreign_data_wrapper.h

 /*-------------------------------------------------------------------------
  *
  * pg_foreign_data_wrapper.h
- *	  definition of the system "foreign-data wrapper" relation (pg_foreign_data_wrapper)
+ *	  definition of the "foreign-data wrapper" system catalog (pg_foreign_data_wrapper)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_foreign_server.h

 /*-------------------------------------------------------------------------
  *
  * pg_foreign_server.h
- *	  definition of the system "foreign server" relation (pg_foreign_server)
+ *	  definition of the "foreign server" system catalog (pg_foreign_server)
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
  * Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_foreign_table.h

 /*-------------------------------------------------------------------------
  *
  * pg_foreign_table.h
- *	  definition of the system "foreign table" relation (pg_foreign_table)
+ *	  definition of the "foreign table" system catalog (pg_foreign_table)
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
  * Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_index.h

 /*-------------------------------------------------------------------------
  *
  * pg_index.h
- *	  definition of the system "index" relation (pg_index)
+ *	  definition of the "index" system catalog (pg_index)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_inherits.h

 /*-------------------------------------------------------------------------
  *
  * pg_inherits.h
- *	  definition of the system "inherits" relation (pg_inherits)
+ *	  definition of the "inherits" system catalog (pg_inherits)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_init_privs.h

 /*-------------------------------------------------------------------------
  *
  * pg_init_privs.h
- *	  definition of the system "initial privileges" relation (pg_init_privs)
+ *	  definition of the "initial privileges" system catalog (pg_init_privs)
  *
  * NOTE: an object is identified by the OID of the row that primarily
  * defines the object, plus the OID of the table that that row appears in.

src/include/catalog/pg_language.dat

 #----------------------------------------------------------------------
 #
 # pg_language.dat
-#    Initial contents of the pg_language system relation.
+#    Initial contents of the pg_language system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_language.h

 /*-------------------------------------------------------------------------
  *
  * pg_language.h
- *	  definition of the system "language" relation (pg_language)
+ *	  definition of the "language" system catalog (pg_language)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_largeobject.h

 /*-------------------------------------------------------------------------
  *
  * pg_largeobject.h
- *	  definition of the system "largeobject" relation (pg_largeobject)
+ *	  definition of the "large object" system catalog (pg_largeobject)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_largeobject_metadata.h

 /*-------------------------------------------------------------------------
  *
  * pg_largeobject_metadata.h
- *	  definition of the system "largeobject_metadata" relation (pg_largeobject_metadata)
+ *	  definition of the "large object metadata" system catalog
+ *	  (pg_largeobject_metadata)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_namespace.dat

 #----------------------------------------------------------------------
 #
 # pg_namespace.dat
-#    Initial contents of the pg_namespace system relation.
+#    Initial contents of the pg_namespace system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_namespace.h

 /*-------------------------------------------------------------------------
  *
  * pg_namespace.h
- *	  definition of the system "namespace" relation (pg_namespace)
+ *	  definition of the "namespace" system catalog (pg_namespace)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_opclass.dat

 #----------------------------------------------------------------------
 #
 # pg_opclass.dat
-#    Initial contents of the pg_opclass system relation.
+#    Initial contents of the pg_opclass system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_opclass.h

 /*-------------------------------------------------------------------------
  *
  * pg_opclass.h
- *	  definition of the system "opclass" relation (pg_opclass)
+ *	  definition of the "operator class" system catalog (pg_opclass)
  *
  * The primary key for this table is <opcmethod, opcname, opcnamespace> ---
  * that is, there is a row for each valid combination of opclass name and

src/include/catalog/pg_operator.dat

 #----------------------------------------------------------------------
 #
 # pg_operator.dat
-#    Initial contents of the pg_operator system relation.
+#    Initial contents of the pg_operator system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_operator.h

 /*-------------------------------------------------------------------------
  *
  * pg_operator.h
- *	  definition of the system "operator" relation (pg_operator)
+ *	  definition of the "operator" system catalog (pg_operator)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_opfamily.dat

 #----------------------------------------------------------------------
 #
 # pg_opfamily.dat
-#    Initial contents of the pg_opfamily system relation.
+#    Initial contents of the pg_opfamily system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_opfamily.h

 /*-------------------------------------------------------------------------
  *
  * pg_opfamily.h
- *	  definition of the system "opfamily" relation (pg_opfamily)
+ *	  definition of the "operator family" system catalog (pg_opfamily)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_partitioned_table.h

 /*-------------------------------------------------------------------------
  *
  * pg_partitioned_table.h
- *	  definition of the system "partitioned table" relation
+ *	  definition of the "partitioned table" system catalog
+ *	  (pg_partitioned_table)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
+ * Portions Copyright (c) 1994, Regents of the University of California
  *
  * src/include/catalog/pg_partitioned_table.h
  *

src/include/catalog/pg_pltemplate.dat

 #----------------------------------------------------------------------
 #
 # pg_pltemplate.dat
-#    Initial contents of the pg_pltemplate system relation.
+#    Initial contents of the pg_pltemplate system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_pltemplate.h

 /*-------------------------------------------------------------------------
  *
  * pg_pltemplate.h
- *	  definition of the system "PL template" relation (pg_pltemplate)
+ *	  definition of the "PL template" system catalog (pg_pltemplate)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_policy.h

 /*-------------------------------------------------------------------------
  *
  * pg_policy.h
- *	 definition of the system "policy" relation (pg_policy)
+ *	  definition of the "policy" system catalog (pg_policy)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_proc.dat

 #----------------------------------------------------------------------
 #
 # pg_proc.dat
-#    Initial contents of the pg_proc system relation.
+#    Initial contents of the pg_proc system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_proc.h

 /*-------------------------------------------------------------------------
  *
  * pg_proc.h
- *	  definition of the system "procedure" relation (pg_proc)
+ *	  definition of the "procedure" system catalog (pg_proc)
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
  * Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_publication.h

 /*-------------------------------------------------------------------------
  *
  * pg_publication.h
- *	  definition of the relation sets relation (pg_publication)
+ *	  definition of the "publication" system catalog (pg_publication)
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
  * Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_publication_rel.h

 /*-------------------------------------------------------------------------
  *
  * pg_publication_rel.h
- *	  definition of the publication to relation map (pg_publication_rel)
-  *
+ *	  definition of the system catalog for mappings between relations and
+ *	  publications (pg_publication_rel)
+ *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
  * Portions Copyright (c) 1994, Regents of the University of California
  *

src/include/catalog/pg_range.dat

 #----------------------------------------------------------------------
 #
 # pg_range.dat
-#    Initial contents of the pg_range system relation.
+#    Initial contents of the pg_range system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_range.h

 /*-------------------------------------------------------------------------
  *
  * pg_range.h
- *	  definition of the system "range" relation (pg_range)
+ *	  definition of the "range type" system catalog (pg_range)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_replication_origin.h

 /*-------------------------------------------------------------------------
  *
  * pg_replication_origin.h
- *	  Persistent replication origin registry
+ *	  definition of the "replication origin" system catalog
+ *	  (pg_replication_origin)
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
  * Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_rewrite.h

 /*-------------------------------------------------------------------------
  *
  * pg_rewrite.h
- *	  definition of the system "rewrite-rule" relation (pg_rewrite)
+ *	  definition of the "rewrite rule" system catalog (pg_rewrite)
  *
  * As of Postgres 7.3, the primary key for this table is <ev_class, rulename>
  * --- ie, rule names are only unique among the rules of a given table.

src/include/catalog/pg_seclabel.h

 /* -------------------------------------------------------------------------
  *
  * pg_seclabel.h
- *	  definition of the system "security label" relation (pg_seclabel)
+ *	  definition of the "security label" system catalog (pg_seclabel)
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
  * Portions Copyright (c) 1994, Regents of the University of California
  *
+ * src/include/catalog/pg_seclabel.h
+ *
+ * NOTES
+ *	  The Catalog.pm module reads this file and derives schema
+ *	  information.
+ *
  * -------------------------------------------------------------------------
  */
 #ifndef PG_SECLABEL_H

src/include/catalog/pg_sequence.h

 /* -------------------------------------------------------------------------
  *
  * pg_sequence.h
- *	  definition of the system "sequence" relation (pg_sequence)
+ *	  definition of the "sequence" system catalog (pg_sequence)
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
  * Portions Copyright (c) 1994, Regents of the University of California
  *
+ * src/include/catalog/pg_sequence.h
+ *
+ * NOTES
+ *	  The Catalog.pm module reads this file and derives schema
+ *	  information.
+ *
  * -------------------------------------------------------------------------
  */
 #ifndef PG_SEQUENCE_H

src/include/catalog/pg_shdepend.h

 /*-------------------------------------------------------------------------
  *
  * pg_shdepend.h
- *	  definition of the system "shared dependency" relation (pg_shdepend)
+ *	  definition of the "shared dependency" system catalog (pg_shdepend)
  *
  * pg_shdepend has no preloaded contents, so there is no pg_shdepend.dat
  * file; system-defined dependencies are loaded into it during a late stage

src/include/catalog/pg_shdescription.h

 /*-------------------------------------------------------------------------
  *
  * pg_shdescription.h
- *	  definition of the system "shared description" relation
+ *	  definition of the "shared description" system catalog
  *	  (pg_shdescription)
  *
  * Because the contents of this table are taken from the *.dat files

src/include/catalog/pg_shseclabel.h

 /* -------------------------------------------------------------------------
  *
  * pg_shseclabel.h
- *	  definition of the system "shared security label" relation (pg_shseclabel)
+ *	  definition of the "shared security label" system catalog (pg_shseclabel)
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
  * Portions Copyright (c) 1994, Regents of the University of California
  *
+ * src/include/catalog/pg_shseclabel.h
+ *
+ * NOTES
+ *	  The Catalog.pm module reads this file and derives schema
+ *	  information.
+ *
  * -------------------------------------------------------------------------
  */
 #ifndef PG_SHSECLABEL_H

src/include/catalog/pg_statistic.h

 /*-------------------------------------------------------------------------
  *
  * pg_statistic.h
- *	  definition of the system "statistic" relation (pg_statistic)
+ *	  definition of the "statistics" system catalog (pg_statistic)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_statistic_ext.h

 /*-------------------------------------------------------------------------
  *
  * pg_statistic_ext.h
- *	  definition of the system "extended statistic" relation (pg_statistic_ext)
+ *	  definition of the "extended statistics" system catalog (pg_statistic_ext)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_subscription.h

 /* -------------------------------------------------------------------------
  *
  * pg_subscription.h
- *		Definition of the subscription catalog (pg_subscription).
+ *	  definition of the "subscription" system catalog (pg_subscription)
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
  * Portions Copyright (c) 1994, Regents of the University of California
  *
+ * src/include/catalog/pg_subscription.h
+ *
+ * NOTES
+ *	  The Catalog.pm module reads this file and derives schema
+ *	  information.
+ *
  * -------------------------------------------------------------------------
  */
 #ifndef PG_SUBSCRIPTION_H

src/include/catalog/pg_subscription_rel.h

 /* -------------------------------------------------------------------------
  *
  * pg_subscription_rel.h
- *		Local info about tables that come from the publisher of a
- *		subscription (pg_subscription_rel).
+ *	  definition of the system catalog containing the state for each
+ *	  replicated table in each subscription (pg_subscription_rel)
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
  * Portions Copyright (c) 1994, Regents of the University of California
  *
+ * src/include/catalog/pg_subscription_rel.h
+ *
+ * NOTES
+ *	  The Catalog.pm module reads this file and derives schema
+ *	  information.
+ *
  * -------------------------------------------------------------------------
  */
 #ifndef PG_SUBSCRIPTION_REL_H

src/include/catalog/pg_tablespace.dat

 #----------------------------------------------------------------------
 #
 # pg_tablespace.dat
-#    Initial contents of the pg_tablespace system relation.
+#    Initial contents of the pg_tablespace system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_tablespace.h

 /*-------------------------------------------------------------------------
  *
  * pg_tablespace.h
- *	  definition of the system "tablespace" relation (pg_tablespace)
+ *	  definition of the "tablespace" system catalog (pg_tablespace)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_transform.h

 /*-------------------------------------------------------------------------
  *
  * pg_transform.h
- *	  definition of the system "transform" relation (pg_transform)
+ *	  definition of the "transform" system catalog (pg_transform)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_trigger.h

 /*-------------------------------------------------------------------------
  *
  * pg_trigger.h
- *	  definition of the system "trigger" relation (pg_trigger)
+ *	  definition of the "trigger" system catalog (pg_trigger)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_ts_config.dat

 #----------------------------------------------------------------------
 #
 # pg_ts_config.dat
-#    Initial contents of the pg_ts_config system relation.
+#    Initial contents of the pg_ts_config system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_ts_config.h

 /*-------------------------------------------------------------------------
  *
  * pg_ts_config.h
- *	definition of configuration of tsearch
+ *	  definition of the "text search configuration" system catalog
+ *	  (pg_ts_config)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_ts_config_map.dat

 #----------------------------------------------------------------------
 #
 # pg_ts_config_map.dat
-#    Initial contents of the pg_ts_config_map system relation.
+#    Initial contents of the pg_ts_config_map system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_ts_config_map.h

 /*-------------------------------------------------------------------------
  *
  * pg_ts_config_map.h
- *	definition of token mappings for configurations of tsearch
+ *	  definition of the system catalog for text search token mappings
+ *	  (pg_ts_config_map)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_ts_dict.dat

 #----------------------------------------------------------------------
 #
 # pg_ts_dict.dat
-#    Initial contents of the pg_ts_dict system relation.
+#    Initial contents of the pg_ts_dict system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_ts_dict.h

 /*-------------------------------------------------------------------------
  *
  * pg_ts_dict.h
- *	definition of dictionaries for tsearch
+ *	  definition of the "text search dictionary" system catalog (pg_ts_dict)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_ts_parser.dat

 #----------------------------------------------------------------------
 #
 # pg_ts_parser.dat
-#    Initial contents of the pg_ts_parser system relation.
+#    Initial contents of the pg_ts_parser system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_ts_parser.h

 /*-------------------------------------------------------------------------
  *
  * pg_ts_parser.h
- *	definition of parsers for tsearch
+ *	  definition of the "text search parser" system catalog (pg_ts_parser)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_ts_template.dat

 #----------------------------------------------------------------------
 #
 # pg_ts_template.dat
-#    Initial contents of the pg_ts_template system relation.
+#    Initial contents of the pg_ts_template system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_ts_template.h

 /*-------------------------------------------------------------------------
  *
  * pg_ts_template.h
- *	definition of dictionary templates for tsearch
+ *	  definition of the "text search template" system catalog (pg_ts_template)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_type.dat

 #----------------------------------------------------------------------
 #
 # pg_type.dat
-#    Initial contents of the pg_type system relation.
+#    Initial contents of the pg_type system catalog.
 #
 # Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California

src/include/catalog/pg_type.h

 /*-------------------------------------------------------------------------
  *
  * pg_type.h
- *	  definition of the system "type" relation (pg_type)
+ *	  definition of the "type" system catalog (pg_type)
  *
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group

src/include/catalog/pg_user_mapping.h

 /*-------------------------------------------------------------------------
  *
  * pg_user_mapping.h
- *	  definition of the system "user mapping" relation (pg_user_mapping)
+ *	  definition of the "user mapping" system catalog (pg_user_mapping)
  *
  * Portions Copyright (c) 1996-2018, PostgreSQL Global Development Group
  * Portions Copyright (c) 1994, Regents of the University of California