From ca5381dae7235ff73e3f6347af004ac9c901e5d2 Mon Sep 17 00:00:00 2001
From: Bruce Momjian <bruce@momjian.us>
Date: Fri, 15 May 2020 08:52:24 -0400
Subject: [PATCH] doc:  make ref/*.sgml file header comment layout consistent

---
 doc/src/sgml/ref/checkpoint.sgml           | 5 ++++-
 doc/src/sgml/ref/create_cast.sgml          | 5 ++++-
 doc/src/sgml/ref/create_collation.sgml     | 5 ++++-
 doc/src/sgml/ref/create_conversion.sgml    | 5 ++++-
 doc/src/sgml/ref/create_foreign_table.sgml | 5 ++++-
 doc/src/sgml/ref/create_function.sgml      | 1 +
 doc/src/sgml/ref/create_transform.sgml     | 5 ++++-
 doc/src/sgml/ref/drop_cast.sgml            | 5 ++++-
 doc/src/sgml/ref/drop_collation.sgml       | 5 ++++-
 doc/src/sgml/ref/drop_conversion.sgml      | 5 ++++-
 doc/src/sgml/ref/drop_foreign_table.sgml   | 5 ++++-
 doc/src/sgml/ref/drop_transform.sgml       | 5 ++++-
 doc/src/sgml/ref/load.sgml                 | 1 +
 doc/src/sgml/ref/pg_config-ref.sgml        | 5 ++++-
 doc/src/sgml/ref/pg_restore.sgml           | 5 ++++-
 doc/src/sgml/ref/pgarchivecleanup.sgml     | 5 ++++-
 doc/src/sgml/ref/pgbench.sgml              | 5 ++++-
 doc/src/sgml/ref/pgtestfsync.sgml          | 5 ++++-
 doc/src/sgml/ref/pgtesttiming.sgml         | 5 ++++-
 doc/src/sgml/ref/pgupgrade.sgml            | 5 ++++-
 doc/src/sgml/ref/set_constraints.sgml      | 6 +++++-
 doc/src/sgml/ref/set_session_auth.sgml     | 6 +++++-
 doc/src/sgml/ref/set_transaction.sgml      | 6 +++++-
 23 files changed, 89 insertions(+), 21 deletions(-)

diff --git a/doc/src/sgml/ref/checkpoint.sgml b/doc/src/sgml/ref/checkpoint.sgml
index fa4dcc4f27d..cc71cc0a621 100644
--- a/doc/src/sgml/ref/checkpoint.sgml
+++ b/doc/src/sgml/ref/checkpoint.sgml
@@ -1,4 +1,7 @@
-<!-- doc/src/sgml/ref/checkpoint.sgml -->
+<!--
+doc/src/sgml/ref/checkpoint.sgml
+PostgreSQL documentation
+-->
 
 <refentry id="sql-checkpoint">
  <indexterm zone="sql-checkpoint">
diff --git a/doc/src/sgml/ref/create_cast.sgml b/doc/src/sgml/ref/create_cast.sgml
index 11266755e56..7f28446f1b1 100644
--- a/doc/src/sgml/ref/create_cast.sgml
+++ b/doc/src/sgml/ref/create_cast.sgml
@@ -1,4 +1,7 @@
-<!-- doc/src/sgml/ref/create_cast.sgml -->
+<!--
+doc/src/sgml/ref/create_cast.sgml
+PostgreSQL documentation
+-->
 
 <refentry id="SQL-CREATECAST">
  <indexterm zone="sql-createcast">
diff --git a/doc/src/sgml/ref/create_collation.sgml b/doc/src/sgml/ref/create_collation.sgml
index d757cdfb434..321874f3d79 100644
--- a/doc/src/sgml/ref/create_collation.sgml
+++ b/doc/src/sgml/ref/create_collation.sgml
@@ -1,4 +1,7 @@
-<!-- doc/src/sgml/ref/create_collation.sgml -->
+<!--
+doc/src/sgml/ref/create_collation.sgml
+PostgreSQL documentation
+-->
 
 <refentry id="SQL-CREATECOLLATION">
  <indexterm zone="sql-createcollation">
diff --git a/doc/src/sgml/ref/create_conversion.sgml b/doc/src/sgml/ref/create_conversion.sgml
index d2e2c010ef3..b7136390bfd 100644
--- a/doc/src/sgml/ref/create_conversion.sgml
+++ b/doc/src/sgml/ref/create_conversion.sgml
@@ -1,4 +1,7 @@
-<!-- doc/src/sgml/ref/create_conversion.sgml -->
+<!--
+doc/src/sgml/ref/create_conversion.sgml
+PostgreSQL documentation
+-->
 
 <refentry id="SQL-CREATECONVERSION">
  <indexterm zone="sql-createconversion">
diff --git a/doc/src/sgml/ref/create_foreign_table.sgml b/doc/src/sgml/ref/create_foreign_table.sgml
index 413b033cb57..1f09d96f21f 100644
--- a/doc/src/sgml/ref/create_foreign_table.sgml
+++ b/doc/src/sgml/ref/create_foreign_table.sgml
@@ -1,4 +1,7 @@
-<!-- doc/src/sgml/ref/create_foreign_table.sgml -->
+<!--
+doc/src/sgml/ref/create_foreign_table.sgml
+PostgreSQL documentation
+-->
 
 <refentry id="SQL-CREATEFOREIGNTABLE">
  <indexterm zone="sql-createforeigntable">
diff --git a/doc/src/sgml/ref/create_function.sgml b/doc/src/sgml/ref/create_function.sgml
index dfa30eb4536..e0743696e17 100644
--- a/doc/src/sgml/ref/create_function.sgml
+++ b/doc/src/sgml/ref/create_function.sgml
@@ -1,5 +1,6 @@
 <!--
 doc/src/sgml/ref/create_function.sgml
+PostgreSQL documentation
 -->
 
 <refentry id="SQL-CREATEFUNCTION">
diff --git a/doc/src/sgml/ref/create_transform.sgml b/doc/src/sgml/ref/create_transform.sgml
index f44ee89d33c..efce32b97df 100644
--- a/doc/src/sgml/ref/create_transform.sgml
+++ b/doc/src/sgml/ref/create_transform.sgml
@@ -1,4 +1,7 @@
-<!-- doc/src/sgml/ref/create_transform.sgml -->
+<!--
+doc/src/sgml/ref/create_transform.sgml
+PostgreSQL documentation
+-->
 
 <refentry id="SQL-CREATETRANSFORM">
  <indexterm zone="sql-createtransform">
diff --git a/doc/src/sgml/ref/drop_cast.sgml b/doc/src/sgml/ref/drop_cast.sgml
index dae3a39fce2..94d2d734cb3 100644
--- a/doc/src/sgml/ref/drop_cast.sgml
+++ b/doc/src/sgml/ref/drop_cast.sgml
@@ -1,4 +1,7 @@
-<!-- doc/src/sgml/ref/drop_cast.sgml -->
+<!--
+doc/src/sgml/ref/drop_cast.sgml
+PostgreSQL documentation
+-->
 
 <refentry id="SQL-DROPCAST">
  <indexterm zone="sql-dropcast">
diff --git a/doc/src/sgml/ref/drop_collation.sgml b/doc/src/sgml/ref/drop_collation.sgml
index f00c88679b7..edde012420f 100644
--- a/doc/src/sgml/ref/drop_collation.sgml
+++ b/doc/src/sgml/ref/drop_collation.sgml
@@ -1,4 +1,7 @@
-<!-- doc/src/sgml/ref/drop_collation.sgml -->
+<!--
+doc/src/sgml/ref/drop_collation.sgml
+PostgreSQL documentation
+-->
 
 <refentry id="SQL-DROPCOLLATION">
  <indexterm zone="sql-dropcollation">
diff --git a/doc/src/sgml/ref/drop_conversion.sgml b/doc/src/sgml/ref/drop_conversion.sgml
index 1a33b3dcc52..3fd31ec878e 100644
--- a/doc/src/sgml/ref/drop_conversion.sgml
+++ b/doc/src/sgml/ref/drop_conversion.sgml
@@ -1,4 +1,7 @@
-<!-- doc/src/sgml/ref/drop_conversion.sgml -->
+<!--
+doc/src/sgml/ref/drop_conversion.sgml
+PostgreSQL documentation
+-->
 
 <refentry id="SQL-DROPCONVERSION">
  <indexterm zone="sql-dropconversion">
diff --git a/doc/src/sgml/ref/drop_foreign_table.sgml b/doc/src/sgml/ref/drop_foreign_table.sgml
index 3c6376413e7..0a20601bc0e 100644
--- a/doc/src/sgml/ref/drop_foreign_table.sgml
+++ b/doc/src/sgml/ref/drop_foreign_table.sgml
@@ -1,4 +1,7 @@
-<!-- doc/src/sggml/ref/drop_foreign_table.sgml -->
+<!--
+doc/src/sggml/ref/drop_foreign_table.sgml
+PostgreSQL documentation
+-->
 
 <refentry id="SQL-DROPFOREIGNTABLE">
  <indexterm zone="sql-dropforeigntable">
diff --git a/doc/src/sgml/ref/drop_transform.sgml b/doc/src/sgml/ref/drop_transform.sgml
index 59ff87cfe48..47e8eea3797 100644
--- a/doc/src/sgml/ref/drop_transform.sgml
+++ b/doc/src/sgml/ref/drop_transform.sgml
@@ -1,4 +1,7 @@
-<!-- doc/src/sgml/ref/drop_transform.sgml -->
+<!--
+doc/src/sgml/ref/drop_transform.sgml
+PostgreSQL documentation
+-->
 
 <refentry id="SQL-DROPTRANSFORM">
  <indexterm zone="sql-droptransform">
diff --git a/doc/src/sgml/ref/load.sgml b/doc/src/sgml/ref/load.sgml
index a5a6ef8e67d..eadf983a702 100644
--- a/doc/src/sgml/ref/load.sgml
+++ b/doc/src/sgml/ref/load.sgml
@@ -1,5 +1,6 @@
 <!--
 doc/src/sgml/ref/load.sgml
+PostgreSQL documentation
 -->
 
 <refentry id="SQL-LOAD">
diff --git a/doc/src/sgml/ref/pg_config-ref.sgml b/doc/src/sgml/ref/pg_config-ref.sgml
index 0210f6389dc..2f86bbd8c27 100644
--- a/doc/src/sgml/ref/pg_config-ref.sgml
+++ b/doc/src/sgml/ref/pg_config-ref.sgml
@@ -1,4 +1,7 @@
-<!-- doc/src/sgml/ref/pg_config-ref.sgml -->
+<!--
+doc/src/sgml/ref/pg_config-ref.sgml
+PostgreSQL documentation
+-->
 
 <refentry id="app-pgconfig">
  <indexterm zone="app-pgconfig">
diff --git a/doc/src/sgml/ref/pg_restore.sgml b/doc/src/sgml/ref/pg_restore.sgml
index 9d7434d401a..a61f9f331e5 100644
--- a/doc/src/sgml/ref/pg_restore.sgml
+++ b/doc/src/sgml/ref/pg_restore.sgml
@@ -1,4 +1,7 @@
-<!-- doc/src/sgml/ref/pg_restore.sgml -->
+<!--
+doc/src/sgml/ref/pg_restore.sgml
+PostgreSQL documentation
+-->
 
 <refentry id="APP-PGRESTORE">
  <indexterm zone="app-pgrestore">
diff --git a/doc/src/sgml/ref/pgarchivecleanup.sgml b/doc/src/sgml/ref/pgarchivecleanup.sgml
index 60a7fc4e6b9..1ad50b0b0d8 100644
--- a/doc/src/sgml/ref/pgarchivecleanup.sgml
+++ b/doc/src/sgml/ref/pgarchivecleanup.sgml
@@ -1,4 +1,7 @@
-<!-- doc/src/sgml/ref/pgarchivecleanup.sgml -->
+<!--
+doc/src/sgml/ref/pgarchivecleanup.sgml
+PostgreSQL documentation
+-->
 
 <refentry id="pgarchivecleanup">
  <indexterm zone="pgarchivecleanup">
diff --git a/doc/src/sgml/ref/pgbench.sgml b/doc/src/sgml/ref/pgbench.sgml
index a64a57395f6..5df3bd0ee26 100644
--- a/doc/src/sgml/ref/pgbench.sgml
+++ b/doc/src/sgml/ref/pgbench.sgml
@@ -1,4 +1,7 @@
-<!-- doc/src/sgml/ref/pgbench.sgml -->
+<!--
+doc/src/sgml/ref/pgbench.sgml
+PostgreSQL documentation
+-->
 
 <refentry id="pgbench">
  <indexterm zone="pgbench">
diff --git a/doc/src/sgml/ref/pgtestfsync.sgml b/doc/src/sgml/ref/pgtestfsync.sgml
index 6e134c75df2..2d600cca1bb 100644
--- a/doc/src/sgml/ref/pgtestfsync.sgml
+++ b/doc/src/sgml/ref/pgtestfsync.sgml
@@ -1,4 +1,7 @@
-<!-- doc/src/sgml/ref/pgtestfsync.sgml -->
+<!--
+doc/src/sgml/ref/pgtestfsync.sgml
+PostgreSQL documentation
+-->
 
 <refentry id="pgtestfsync">
  <indexterm zone="pgtestfsync">
diff --git a/doc/src/sgml/ref/pgtesttiming.sgml b/doc/src/sgml/ref/pgtesttiming.sgml
index d5e231fff7b..985053833d3 100644
--- a/doc/src/sgml/ref/pgtesttiming.sgml
+++ b/doc/src/sgml/ref/pgtesttiming.sgml
@@ -1,4 +1,7 @@
-<!-- doc/src/sgml/ref/pgtesttiming.sgml -->
+<!--
+doc/src/sgml/ref/pgtesttiming.sgml
+PostgreSQL documentation
+-->
 
 <refentry id="pgtesttiming">
  <indexterm zone="pgtesttiming">
diff --git a/doc/src/sgml/ref/pgupgrade.sgml b/doc/src/sgml/ref/pgupgrade.sgml
index 06a32d80f21..6936941adbc 100644
--- a/doc/src/sgml/ref/pgupgrade.sgml
+++ b/doc/src/sgml/ref/pgupgrade.sgml
@@ -1,4 +1,7 @@
-<!-- doc/src/sgml/ref/pgupgrade.sgml -->
+<!--
+doc/src/sgml/ref/pgupgrade.sgml
+PostgreSQL documentation
+-->
 
 <refentry id="pgupgrade">
  <indexterm zone="pgupgrade">
diff --git a/doc/src/sgml/ref/set_constraints.sgml b/doc/src/sgml/ref/set_constraints.sgml
index 7c31871b0bd..ce9faca4976 100644
--- a/doc/src/sgml/ref/set_constraints.sgml
+++ b/doc/src/sgml/ref/set_constraints.sgml
@@ -1,4 +1,8 @@
-<!-- doc/src/sgml/ref/set_constraints.sgml -->
+<!--
+doc/src/sgml/ref/set_constraints.sgml
+PostgreSQL documentation
+-->
+
 <refentry id="SQL-SET-CONSTRAINTS">
  <indexterm zone="sql-set-constraints">
   <primary>SET CONSTRAINTS</primary>
diff --git a/doc/src/sgml/ref/set_session_auth.sgml b/doc/src/sgml/ref/set_session_auth.sgml
index 4ac21289507..514d1c807ce 100644
--- a/doc/src/sgml/ref/set_session_auth.sgml
+++ b/doc/src/sgml/ref/set_session_auth.sgml
@@ -1,4 +1,8 @@
-<!-- doc/src/sgml/ref/set_session_auth.sgml -->
+<!--
+doc/src/sgml/ref/set_session_auth.sgml
+PostgreSQL documentation
+-->
+
 <refentry id="SQL-SET-SESSION-AUTHORIZATION">
  <indexterm zone="sql-set-session-authorization">
   <primary>SET SESSION AUTHORIZATION</primary>
diff --git a/doc/src/sgml/ref/set_transaction.sgml b/doc/src/sgml/ref/set_transaction.sgml
index ca55a5b1966..703a5fc3bfe 100644
--- a/doc/src/sgml/ref/set_transaction.sgml
+++ b/doc/src/sgml/ref/set_transaction.sgml
@@ -1,4 +1,8 @@
-<!-- doc/src/sgml/ref/set_transaction.sgml -->
+<!--
+doc/src/sgml/ref/set_transaction.sgml
+PostgreSQL documentation
+-->
+
 <refentry id="SQL-SET-TRANSACTION">
  <indexterm zone="sql-set-transaction">
   <primary>SET TRANSACTION</primary>
-- 
2.39.5