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

2025-05-05 09:19:17 +03:00 · 2020-05-15 08:52:24 -04:00 · 2020-05-15 08:52:24 -04:00 · ce71624a25
commit ce71624a25
parent a1466e194e
23 changed files with 89 additions and 21 deletions
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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">
--- 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>
--- 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>
--- 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>