doc for indexStoreDocText

src/sampleconf/recoll.conf

@@ -241,19 +241,27 @@ indexStripChars = 1
 # performance for the old method is Chert, which is default for 1.2, still
 # supported but not default in 1.4 and will be dropped in 1.6.
 #
-# The document text is translated from its original format to UTF-8 plain
-# text, but not stripped of upper-case, diacritics, or punctuation
+# The stored document text is translated from its original format to UTF-8
+# plain text, but not stripped of upper-case, diacritics, or punctuation
 # signs. Storing it increases the index size by 10-20% typically, but also
 # allows for nicer snippets, so it may be worth enabling it even if not
 # strictly needed for performance if you can afford the space.
 #
-# The variable only has an effect when creating an index, tested as
-# xapiandb directory not existing. Its exact effect depends on the Xapian
-# version. For Xapian 1.2, you can force the new method by setting the
-# variable to 1. For Xapian 1.4, the Chert format will be used, and the text
-# will not be stored if the variable is not set or set to 0. For later
-# Xapian versions, the variable does nothing, the text is always stored.
-# </desc></var>
+# The variable only has an effect when creating an index, meaning that the
+# xapiandb directory must not exist yet. Its exact effect depends on the
+# Xapian version.
+#
+# For Xapian 1.4, if the variable is set to 0, the Chert format will be
+# used, and the text will not be stored. If the variable is 1, Glass will
+# be used, and the text stored.
+#
+# For Xapian 1.2, and for versions after 1.5 and newer, the index format is
+# always the default, but the variable controls if the text is stored or
+# not, and the abstract generation method. With Xapian 1.5 and later, and
+# the variable set to 0, abstract generation may be very slow, but this
+# setting may still be useful to save space if you do not use abstract
+# generation at all.
+# </descr></var>
 indexStoreDocText = 1
 
 # <var name="nonumbers" type="bool"><brief>Decides if terms will be