doc: make ref/*.sgml file header comment layout consistent

24 files changed, 90 insertions, 21 deletions

diff --git a/doc/src/sgml/ref/checkpoint.sgml b/doc/src/sgml/ref/checkpoint.sgml
index dfcadcf402..2afee6d7b5 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 84317047c2..2b4d4d5573 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 def4dda6e8..58f5f0cd63 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 67b4bd26be..e7700fecfc 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 f9c214ea88..3ee0f2d635 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 dd6a2f7304..f81cedc823 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_procedure.sgml b/doc/src/sgml/ref/create_procedure.sgml
index 6c1de34b01..0ea6513cb5 100644
--- a/doc/src/sgml/ref/create_procedure.sgml
+++ b/doc/src/sgml/ref/create_procedure.sgml
@@ -1,5 +1,6 @@
 <!--
 doc/src/sgml/ref/create_procedure.sgml
+PostgreSQL documentation
 -->
 
 <refentry id="sql-createprocedure">
diff --git a/doc/src/sgml/ref/create_transform.sgml b/doc/src/sgml/ref/create_transform.sgml
index 4bce36b41a..5b46c23196 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 9f42867e12..5cb704b7a3 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 89b975aac3..60867b01d9 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 131e3cbc0b..08558ad771 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 7e4c667c51..07b3fd4251 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/sgml/ref/drop_foreign_table.sgml -->
+<!--
+doc/src/sgml/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 582e782219..d25cb51604 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 506699ef6f..2c214dd726 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 b819f3f345..6c797746cc 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 e9a145ad6e..232f88024f 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 84c2df572a..56f02fc0e6 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 4df31f3bc4..f5a51d3732 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 c6aa5673f1..95be7a16d2 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 798aed3609..a5eb3aa25e 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 997ef1e12a..905167690b 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 671332afc7..d91965a44b 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 37b9ff8b18..6a838e58b7 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 43b1c6c892..ec436b2d16 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>