aboutsummaryrefslogtreecommitdiff
path: root/doc/src/sgml/spgist.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/src/sgml/spgist.sgml')
-rw-r--r--doc/src/sgml/spgist.sgml12
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/src/sgml/spgist.sgml b/doc/src/sgml/spgist.sgml
index 34ea181db71..0e3cc814f15 100644
--- a/doc/src/sgml/spgist.sgml
+++ b/doc/src/sgml/spgist.sgml
@@ -938,6 +938,18 @@ typedef struct spgLeafConsistentOut
fails to do that, the <acronym>SP-GiST</acronym> core resorts to
extraordinary measures described in <xref linkend="spgist-all-the-same"/>.
</para>
+
+ <para>
+ When <structfield>longValuesOK</structfield> is true, it is expected
+ that successive levels of the <acronym>SP-GiST</acronym> tree will
+ absorb more and more information into the prefixes and node labels of
+ the inner tuples, making the required leaf datum smaller and smaller,
+ so that eventually it will fit on a page.
+ To prevent bugs in operator classes from causing infinite insertion
+ loops, the <acronym>SP-GiST</acronym> core will raise an error if the
+ leaf datum does not become any smaller within ten cycles
+ of <function>choose</function> method calls.
+ </para>
</sect2>
<sect2 id="spgist-null-labels">