docs: Merge separate chapters on built-in index AMs into one.

The documentation index is getting very long, which makes it hard
to find things. Since these chapters are all very similar in structure
and content, merging them is a natural way of reducing the size of
the toplevel index.

Rather than actually combining all of the SGML into a single file,
keep one file per , and add a glue file that includes all
of them.

Discussion: http://postgr.es/m/CA+Tgmob7_uoYuS2=rVwpVXaRwP-UXz+++saYTC-BCZ42QzSNKQ@mail.gmail.com

diff --git a/doc/src/sgml/brin.sgml b/doc/src/sgml/brin.sgml
index d898cc4720c00c58e797afb74ae6be32e3b9902e..64fb520db7e5129eabb1859a5f21d2f018ba0f2b 100644 (file)
--- a/doc/src/sgml/brin.sgml
+++ b/doc/src/sgml/brin.sgml
@@ -1,6 +1,6 @@
 
 
-<chapter id="brin">
+<sect1 id="brin">
 BRIN Indexes
 
    
@@ -8,7 +8,7 @@
     BRIN
    
 
-1 id="brin-intro">
+2 id="brin-intro">
  Introduction
 
  
@@ -64,7 +64,7 @@
   be more precise and more data blocks can be skipped during an index scan.
  
 
- 2 id="brin-operation">
+ 3 id="brin-operation">
   Index Maintenance
 
   
@@ -136,10 +136,10 @@ LOG:  request for BRIN range summarization for index "brin_wi_idx" page 128 was
    See  for details.
   
 
- 2>
-1>
+ 3>
+2>
 
-1 id="brin-builtin-opclasses">
+2 id="brin-builtin-opclasses">
  Built-in Operator Classes
 
  
@@ -743,7 +743,7 @@ LOG:  request for BRIN range summarization for index "brin_wi_idx" page 128 was
   
  
 
-  2 id="brin-builtin-opclasses--parameters">
+  3 id="brin-builtin-opclasses--parameters">
    Operator Class Parameters
 
    
@@ -808,11 +808,11 @@ LOG:  request for BRIN range summarization for index "brin_wi_idx" page 128 was
    
 
    
-  2>
+  3>
 
-1>
+2>
 
-1 id="brin-extensibility">
+2 id="brin-extensibility">
  Extensibility
 
  
@@ -1340,5 +1340,5 @@ typedef struct BrinOpcInfo
     float4_minmax_ops as an example of minmax, and
     box_inclusion_ops as an example of inclusion.
  
+
 
-

diff --git a/doc/src/sgml/btree.sgml b/doc/src/sgml/btree.sgml
index be8210286b63220576c72cca8e3ad60ea99fa3f5..2b3997988cff0fd38db32da643266c05fab7ba1a 100644 (file)
--- a/doc/src/sgml/btree.sgml
+++ b/doc/src/sgml/btree.sgml
@@ -1,6 +1,6 @@
 
 
-<chapter id="btree">
+<sect1 id="btree">
 B-Tree Indexes
 
    
@@ -8,7 +8,7 @@
     B-Tree
    
 
-1 id="btree-intro">
+2 id="btree-intro">
  Introduction
 
  
@@ -30,9 +30,9 @@
   btree AM make use of them.
  
 
-1>
+2>
 
-1 id="btree-behavior">
+2 id="btree-behavior">
  Behavior of B-Tree Operator Classes
 
  
@@ -200,9 +200,9 @@
   planner relies on them for optimization purposes.
  
 
-1>
+2>
 
-1 id="btree-support-funcs">
+2 id="btree-support-funcs">
  B-Tree Support Functions
 
  
@@ -585,9 +585,9 @@ options(relopts local_relopts *) returns
   
  
 
-1>
+2>
 
-1 id="btree-implementation">
+2 id="btree-implementation">
  Implementation
 
  
@@ -597,7 +597,7 @@ options(relopts local_relopts *) returns
   distribution for a much more detailed, internals-focused description
   of the B-Tree implementation.
  
- 2 id="btree-structure">
+ 3 id="btree-structure">
   B-Tree Structure
   
    PostgreSQL B-Tree indexes are
@@ -627,9 +627,9 @@ options(relopts local_relopts *) returns
    the tree structure by creating a new root page that is one level
    above the original root page.
   
- 2>
+ 3>
 
- 2 id="btree-deletion">
+ 3 id="btree-deletion">
   Bottom-up Index Deletion
   
    B-Tree indexes are not directly aware that under MVCC, there might
@@ -731,9 +731,9 @@ options(relopts local_relopts *) returns
    two logical rows whose lifetimes span the same
    VACUUM cycle).
   
- 2>
+ 3>
 
- 2 id="btree-deduplication">
+ 3 id="btree-deduplication">
   Deduplication
   
    A duplicate is a leaf page tuple (a tuple that points to a table
@@ -908,7 +908,7 @@ options(relopts local_relopts *) returns
    
   
 
- 2>
-1>
+ 3>
+2>
 
-chapter>
+sect1>

diff --git a/doc/src/sgml/filelist.sgml b/doc/src/sgml/filelist.sgml
index 6360707d9f698b61060980865d3208c29c2a6ea3..3fb0709f5dfc868f240aa08be9bda6d4815da9bd 100644 (file)
--- a/doc/src/sgml/filelist.sgml
+++ b/doc/src/sgml/filelist.sgml
@@ -85,6 +85,7 @@
 
 
 
+
 
 
 

diff --git a/doc/src/sgml/gin.sgml b/doc/src/sgml/gin.sgml
index 5bd1efae92e67a365b859ee436101c6904195a36..46e87e01324dd00c460dd98746788bd95d5ccfa3 100644 (file)
--- a/doc/src/sgml/gin.sgml
+++ b/doc/src/sgml/gin.sgml
@@ -1,6 +1,6 @@
 
 
-<chapter id="gin">
+<sect1 id="gin">
 GIN Indexes
 
    
@@ -8,7 +8,7 @@
     GIN
    
 
-1 id="gin-intro">
+2 id="gin-intro">
  Introduction
 
  
@@ -60,9 +60,9 @@
   information about GIN on their
   website.
  
-1>
+2>
 
-1 id="gin-builtin-opclasses">
+2 id="gin-builtin-opclasses">
  Built-in Operator Classes
 
  
@@ -140,9 +140,9 @@
   See  for details.
  
 
-1>
+2>
 
-1 id="gin-extensibility">
+2 id="gin-extensibility">
  Extensibility
 
  
@@ -458,9 +458,9 @@
   though the actual type might be something else depending on the operator.
  
 
-1>
+2>
 
-1 id="gin-implementation">
+2 id="gin-implementation">
  Implementation
 
  
@@ -497,7 +497,7 @@
   
  
 
- 2 id="gin-fast-update">
+ 3 id="gin-fast-update">
   GIN Fast Update Technique
 
   
@@ -535,9 +535,9 @@
    GIN index.  See 
    for details.
   
- 2>
+ 3>
 
- 2 id="gin-partial-match">
+ 3 id="gin-partial-match">
   Partial Match Algorithm
 
   
@@ -554,11 +554,11 @@
    to be searched, or greater than zero if the index key is past the range
    that could match.
   
- 2>
+ 3>
 
-1>
+2>
 
-1 id="gin-tips">
+2 id="gin-tips">
 GIN Tips and Tricks
 
  
@@ -653,9 +653,9 @@
   
  
 
-1>
+2>
 
-1 id="gin-limit">
+2 id="gin-limit">
  Limitations
 
  
@@ -667,9 +667,9 @@
   however that null key values contained within a non-null composite item
   or query value are supported.
  
-1>
+2>
 
-1 id="gin-examples">
+2 id="gin-examples">
  Examples
 
  
@@ -709,6 +709,6 @@
   
  
  
-1>
+2>
 
-chapter>
+sect1>

diff --git a/doc/src/sgml/gist.sgml b/doc/src/sgml/gist.sgml
index 8a19f156d83c3a19e54733cfca97b912803366a5..3f7df103b8302b1e374f491eb0fee4f15f3b9d78 100644 (file)
--- a/doc/src/sgml/gist.sgml
+++ b/doc/src/sgml/gist.sgml
@@ -1,6 +1,6 @@
 
 
-<chapter id="gist">
+<sect1 id="gist">
 GiST Indexes
 
    
@@ -8,7 +8,7 @@
     GiST
    
 
-1 id="gist-intro">
+2 id="gist-intro">
  Introduction
 
  
@@ -38,9 +38,9 @@
     web site.
   
 
-1>
+2>
 
-1 id="gist-builtin-opclasses">
+2 id="gist-builtin-opclasses">
  Built-in Operator Classes
 
  
@@ -222,9 +222,9 @@ CREATE INDEX ON my_table USING GIST (my_inet_column inet_ops);
 
  
 
-1>
+2>
 
-1 id="gist-extensibility">
+2 id="gist-extensibility">
  Extensibility
 
  
@@ -1260,12 +1260,12 @@ my_stratnum(PG_FUNCTION_ARGS)
    will accumulate for the duration of the operation.
   
 
-1>
+2>
 
-1 id="gist-implementation">
+2 id="gist-implementation">
  Implementation
 
- 2 id="gist-buffering-build">
+ 3 id="gist-buffering-build">
   GiST Index Build Methods
 
   
@@ -1314,10 +1314,10 @@ my_stratnum(PG_FUNCTION_ARGS)
    is ordered.
   
 
- 2>
-1>
+ 3>
+2>
 
-1 id="gist-examples">
+2 id="gist-examples">
  Examples
 
  
@@ -1382,6 +1382,6 @@ my_stratnum(PG_FUNCTION_ARGS)
  
  
 
-1>
+2>
 
-chapter>
+sect1>

diff --git a/doc/src/sgml/hash.sgml b/doc/src/sgml/hash.sgml
index e35911ebf8eb4422a88fac78ce964de1b18c82dd..9e69ef91fe834886ecfafccd83e74c4660dd8920 100644 (file)
--- a/doc/src/sgml/hash.sgml
+++ b/doc/src/sgml/hash.sgml
@@ -1,6 +1,6 @@
 
 
-<chapter id="hash-index">
+<sect1 id="hash-index">
 Hash Indexes
 
    
@@ -8,7 +8,7 @@
     Hash
    
 
-1 id="hash-intro">
+2 id="hash-intro">
  Overview
 
  
@@ -108,9 +108,9 @@
   with rapidly increasing number of rows.
  
 
-1>
+2>
 
-1 id="hash-implementation">
+2 id="hash-implementation">
  Implementation
 
  
@@ -157,6 +157,6 @@
   successfully.
  
 
-1>
+2>
 
-chapter>
+sect1>

diff --git a/doc/src/sgml/indextypes.sgml b/doc/src/sgml/indextypes.sgml
new file mode 100644 (file)
index 0000000..94a2b01
--- /dev/null
+++ b/doc/src/sgml/indextypes.sgml
@@ -0,0 +1,13 @@
+ 
+
+
+Built-in Index Access Methods
+
+&btree;
+&gist;
+&spgist;
+&gin;
+&brin;
+&hash;
+
+

diff --git a/doc/src/sgml/postgres.sgml b/doc/src/sgml/postgres.sgml
index 1ac9d3a9b8fff99329334dc8902e0f121f106b6a..e9a350234e7a5fc26433613525962d33a4f9a894 100644 (file)
--- a/doc/src/sgml/postgres.sgml
+++ b/doc/src/sgml/postgres.sgml
@@ -258,12 +258,7 @@ break is not needed in a wider output rendering.
   &indexam;
   &generic-wal;
   &custom-rmgr;
-  &btree;
-  &gist;
-  &spgist;
-  &gin;
-  &brin;
-  &hash;
+  &indextypes;
   &storage;
   &transaction;
   &bki;

diff --git a/doc/src/sgml/spgist.sgml b/doc/src/sgml/spgist.sgml
index 102f8627bd05d5a93c2b60e0596a0c8572985b63..6af93719b843921d2b2e7b3882e1145cb30afb38 100644 (file)
--- a/doc/src/sgml/spgist.sgml
+++ b/doc/src/sgml/spgist.sgml
@@ -1,6 +1,6 @@
 
 
-<chapter id="spgist">
+<sect1 id="spgist">
 SP-GiST Indexes
 
    
@@ -8,7 +8,7 @@
     SP-GiST
    
 
-1 id="spgist-intro">
+2 id="spgist-intro">
  Introduction
 
  
@@ -51,9 +51,9 @@
   web site.
  
 
-1>
+2>
 
-1 id="spgist-builtin-opclasses">
+2 id="spgist-builtin-opclasses">
  Built-in Operator Classes
 
  
@@ -191,9 +191,9 @@
   search over indexed point or polygon data sets.
  
 
-1>
+2>
 
-1 id="spgist-extensibility">
+2 id="spgist-extensibility">
  Extensibility
 
  
@@ -933,9 +933,9 @@ LANGUAGE C STRICT;
    PG_GET_COLLATION() mechanism.
   
 
-1>
+2>
 
-1 id="spgist-implementation">
+2 id="spgist-implementation">
  Implementation
 
   
@@ -944,7 +944,7 @@ LANGUAGE C STRICT;
    know.
   
 
- 2 id="spgist-limits">
+ 3 id="spgist-limits">
   SP-GiST Limits
 
   
@@ -991,9 +991,9 @@ LANGUAGE C STRICT;
    leaf datum does not become any smaller within ten cycles
    of choose method calls.
   
- 2>
+ 3>
 
- 2 id="spgist-null-labels">
+ 3 id="spgist-null-labels">
   SP-GiST Without Node Labels
 
   
@@ -1018,9 +1018,9 @@ LANGUAGE C STRICT;
    for choose to return spgAddNode, since the set
    of nodes is supposed to be fixed in such cases.
   
- 2>
+ 3>
 
- 2 id="spgist-all-the-same">
+ 3 id="spgist-all-the-same">
   <quote>All-the-Same</quote> Inner Tuples
 
   
@@ -1056,11 +1056,11 @@ LANGUAGE C STRICT;
    depending on how much the inner_consistent function normally
    assumes about the meaning of the nodes.
   
- 2>
+ 3>
 
-1>
+2>
 
-1 id="spgist-examples">
+2 id="spgist-examples">
  Examples
 
  
@@ -1071,6 +1071,6 @@ LANGUAGE C STRICT;
   and src/backend/utils/adt/ to see the code.
  
 
-1>
+2>
 
-chapter>
+sect1>