Fix ordering/categorization of some recently-added system views.
authorTom Lane
Thu, 5 May 2016 16:33:13 +0000 (12:33 -0400)
committerTom Lane
Thu, 5 May 2016 16:33:13 +0000 (12:33 -0400)
Somebody added pg_replication_origin, pg_replication_origin_status and
pg_replication_slots to catalogs.sgml without a whole lot of concern for
either alphabetical order or the difference between a table and a view.
Clean up the mess.

Back-patch to 9.5, not so much because this is critical as because if
I don't it will result in a cross-branch divergence in release-9.5.sgml,
which would be a maintenance hazard.

doc/src/sgml/catalogs.sgml
doc/src/sgml/high-availability.sgml
doc/src/sgml/logicaldecoding.sgml
doc/src/sgml/release-9.5.sgml
doc/src/sgml/replication-origins.sgml

index 90a137bc0d35345912452765b6a34d91d0de2466..0ef6ef111ea8f6bffab9c620c996f8430fa6dc92 100644 (file)
       information about range types
      
 
-     
-      pg_rewrite
-      query rewrite rules
-     
-
      
       pg_replication_origin
       registered replication origins
      
 
      
-      pg_replication_origin_status
-      information about replication origins, including replication progress
-     
-
-     
-      pg_replication_slots
-      replication slot information
+      pg_rewrite
+      query rewrite rules
      
 
      
 
  
 
+  <structname>pg_replication_origin</structname>
+
+  
+   pg_replication_origin
+  
+
+  
+   The pg_replication_origin catalog contains
+   all replication origins created.  For more on replication origins
+   see .
+  
+
+  
+
+   <structname>pg_replication_origin</structname> Columns
+
+   
+    
+     
+      Name
+      Type
+      References
+      Description
+     
+    
+
+    
+     
+      roident
+      Oid
+      
+      A unique, cluster-wide identifier for the replication
+      origin. Should never leave the system.
+     
+
+     
+      roname
+      text
+      
+      The external, user defined, name of a replication
+      origin.
+     
+    
+   
+  
+
  
   <structname>pg_rewrite</structname>
 
 
  
 
-  <structname>pg_replication_origin</structname>
-
-  
-   pg_replication_origin
-  
-
-  
-   The pg_replication_origin catalog contains
-   all replication origins created.  For more on replication origins
-   see .
-  
-
-  
-
-   <structname>pg_replication_origin</structname> Columns
-
-   
-    
-     
-      Name
-      Type
-      References
-      Description
-     
-    
-
-    
-     
-      roident
-      Oid
-      
-      A unique, cluster-wide identifier for the replication
-      origin. Should never leave the system.
-     
-
-     
-      roname
-      text
-      
-      The external, user defined, name of a replication
-      origin.
-     
-    
-   
-  
-
-  
-  <structname>pg_replication_origin_status</structname>
-
-  
-   pg_replication_origin_status
-  
-
-  
-   The pg_replication_origin_status view
-   contains information about how far replay for a certain origin has
-   progressed.  For more on replication origins
-   see .
-  
-
-  
-
-   <structname>pg_replication_origin_status</structname> Columns
-
-   
-    
-     
-      Name
-      Type
-      References
-      Description
-     
-    
-
-    
-     
-      local_id
-      Oid
-      pg_replication_origin.roident
-      internal node identifier
-     
-
-     
-      external_id
-      text
-      pg_replication_origin.roname
-      external node identifier
-     
-
-     
-      remote_lsn
-      pg_lsn
-      
-      The origin node's LSN up to which data has been replicated.
-     
-
-
-     
-      local_lsn
-      pg_lsn
-      
-      
-       This node's LSN at which remote_lsn has
-       been replicated. Used to flush commit records before persisting
-       data to disk when using asynchronous commits.
-      
-     
-    
-   
-  
-
-  <structname>pg_replication_slots</structname>
-
-  
-   pg_replication_slots
-  
-
-  
-   The pg_replication_slots view provides a listing
-   of all replication slots that currently exist on the database cluster,
-   along with their current state.
-  
-
-  
-   For more on replication slots,
-   see  and .
-  
-
-  
-
-   <structname>pg_replication_slots</structname> Columns
-
-   
-    
-     
-      Name
-      Type
-      References
-      Description
-     
-    
-
-    
-     
-      slot_name
-      name
-      
-      A unique, cluster-wide identifier for the replication slot
-     
-
-     
-      plugin
-      name
-      
-      The base name of the shared object containing the output plugin this logical slot is using, or null for physical slots.
-     
-
-     
-      slot_type
-      text
-      
-      The slot type - physical or logical
-     
-
-     
-      datoid
-      oid
-      pg_database.oid
-      The OID of the database this slot is associated with, or
-      null. Only logical slots have an associated database.
-     
-
-     
-      database
-      text
-      pg_database.datname
-      The name of the database this slot is associated with, or
-      null. Only logical slots have an associated database.
-     
-
-     
-      active
-      boolean
-      
-      True if this slot is currently actively being used
-     
-
-     
-      active_pid
-      integer
-      
-      The process ID of the session using this slot if the slot
-       is currently actively being used. NULL if
-       inactive.
-      
-     
-
-     
-      xmin
-      xid
-      
-      The oldest transaction that this slot needs the database to
-      retain.  VACUUM cannot remove tuples deleted
-      by any later transaction.
-      
-     
-
-     
-      catalog_xmin
-      xid
-      
-      The oldest transaction affecting the system catalogs that this
-      slot needs the database to retain.  VACUUM cannot
-      remove catalog tuples deleted by any later transaction.
-      
-     
-
-     
-      restart_lsn
-      pg_lsn
-      
-      The address (LSN) of oldest WAL which still
-      might be required by the consumer of this slot and thus won't be
-      automatically removed during checkpoints.
-      
-     
-    
-   
-  
-
  
   <structname>pg_seclabel</structname>
 
       prepared transactions
      
 
+     
+      pg_replication_origin_status
+      information about replication origins, including replication progress
+     
+
+     
+      pg_replication_slots
+      replication slot information
+     
+
      
       pg_roles
       database roles
@@ -8760,6 +8573,193 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx
 
  
 
+  
+  <structname>pg_replication_origin_status</structname>
+
+  
+   pg_replication_origin_status
+  
+
+  
+   The pg_replication_origin_status view
+   contains information about how far replay for a certain origin has
+   progressed.  For more on replication origins
+   see .
+  
+
+  
+
+   <structname>pg_replication_origin_status</structname> Columns
+
+   
+    
+     
+      Name
+      Type
+      References
+      Description
+     
+    
+
+    
+     
+      local_id
+      Oid
+      pg_replication_origin.roident
+      internal node identifier
+     
+
+     
+      external_id
+      text
+      pg_replication_origin.roname
+      external node identifier
+     
+
+     
+      remote_lsn
+      pg_lsn
+      
+      The origin node's LSN up to which data has been replicated.
+     
+
+     
+      local_lsn
+      pg_lsn
+      
+      
+       This node's LSN at which remote_lsn has
+       been replicated. Used to flush commit records before persisting
+       data to disk when using asynchronous commits.
+      
+     
+    
+   
+  
+
+  <structname>pg_replication_slots</structname>
+
+  
+   pg_replication_slots
+  
+
+  
+   The pg_replication_slots view provides a listing
+   of all replication slots that currently exist on the database cluster,
+   along with their current state.
+  
+
+  
+   For more on replication slots,
+   see  and .
+  
+
+  
+
+   <structname>pg_replication_slots</structname> Columns
+
+   
+    
+     
+      Name
+      Type
+      References
+      Description
+     
+    
+
+    
+     
+      slot_name
+      name
+      
+      A unique, cluster-wide identifier for the replication slot
+     
+
+     
+      plugin
+      name
+      
+      The base name of the shared object containing the output plugin this logical slot is using, or null for physical slots.
+     
+
+     
+      slot_type
+      text
+      
+      The slot type - physical or logical
+     
+
+     
+      datoid
+      oid
+      pg_database.oid
+      The OID of the database this slot is associated with, or
+      null. Only logical slots have an associated database.
+     
+
+     
+      database
+      text
+      pg_database.datname
+      The name of the database this slot is associated with, or
+      null. Only logical slots have an associated database.
+     
+
+     
+      active
+      boolean
+      
+      True if this slot is currently actively being used
+     
+
+     
+      active_pid
+      integer
+      
+      The process ID of the session using this slot if the slot
+       is currently actively being used. NULL if
+       inactive.
+      
+     
+
+     
+      xmin
+      xid
+      
+      The oldest transaction that this slot needs the database to
+      retain.  VACUUM cannot remove tuples deleted
+      by any later transaction.
+      
+     
+
+     
+      catalog_xmin
+      xid
+      
+      The oldest transaction affecting the system catalogs that this
+      slot needs the database to retain.  VACUUM cannot
+      remove catalog tuples deleted by any later transaction.
+      
+     
+
+     
+      restart_lsn
+      pg_lsn
+      
+      The address (LSN) of oldest WAL which still
+      might be required by the consumer of this slot and thus won't be
+      automatically removed during checkpoints.
+      
+     
+
+    
+   
+  
+
  
   <structname>pg_roles</structname>
 
index e4a50ba6549c0c09208f5c1854c09f2d7457c42f..1f1fb463436015ffc5c38234da52d9f88f24ab27 100644 (file)
@@ -914,7 +914,7 @@ primary_conninfo = 'host=192.168.1.50 port=5432 user=foo password=foopass'
     
     
      Existing replication slots and their state can be seen in the
-     catalog-pg-replication-slots">pg_replication_slots
+     view-pg-replication-slots">pg_replication_slots
      view.
     
     
index 93f8e4ebdf92ce073f19bb305aca3985b2ae37cb..b6acf907598ca5caafec073a5e0a09af32a9ff19 100644 (file)
@@ -324,7 +324,7 @@ $ pg_recvlogical -d postgres --slot test --drop-slot
    System Catalogs Related to Logical Decoding
 
    
-    The catalog-pg-replication-slots">pg_replication_slots
+    The view-pg-replication-slots">pg_replication_slots
     view and the
     pg_stat_replication
     view provide information about the current state of replication slots and
index d64655b007a34896ab60451041b0d9ecae3b3f55..a66b4fcfcfbd3b1bb0efae774a15edec5300a1c2 100644 (file)
@@ -2176,7 +2176,7 @@ Add GUC and storage parameter to set the maximum size of GIN pending list.
 -->
        
         Report the processes holding replication slots in 
-        linkend="catalog-pg-replication-slots">pg_replication_slots
+        linkend="view-pg-replication-slots">pg_replication_slots
         (Craig Ringer)
        
 
index fdc41c99d772161c3cbace97b305b161e133b05e..317ca9a1dfbf3d175c9f855d41ec012eeb87d9f8 100644 (file)
@@ -66,7 +66,7 @@
   pg_replication_origin_xact_setup().
   If that's done replication progress will persist in a crash safe
   manner. Replay progress for all replication origins can be seen in the
-  catalog-pg-replication-origin-status">
+  view-pg-replication-origin-status">
    pg_replication_origin_status
    view. An individual origin's progress, e.g. when resuming
   replication, can be acquired using