[elpa] externals/preview-auto 833ee8af8f: * preview-auto.el (preview-auto-barriers): expand docstring

[ELPA Syncer]

branch: externals/preview-auto
commit 833ee8af8fd65821c1630eaab02a18b99cea1b5a
Author: Paul Nelson <ultrono@gmail.com>
Commit: Paul Nelson <ultrono@gmail.com>

    * preview-auto.el (preview-auto-barriers): expand docstring
---
 preview-auto.el | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/preview-auto.el b/preview-auto.el
index 489ecbca08..1e3d4993fc 100644
--- a/preview-auto.el
+++ b/preview-auto.el
@@ -272,7 +272,11 @@ Example: (nil t t t nil nil t nil) => ((1 . 3) (6 . 6))"
     "\\\\subsubsection"
     "\\\\paragraph"
     "\\\\subparagraph")
-  "List of barrier regexps, excluded from in regions sent for previewing."
+  "List of barrier regexps, excluded from in regions sent for previewing.
+The motivation for the default value is to avoid attempting to preview
+comment regions (where functions such as texmathp occasionally fail),
+and to avoid crossing section labels, which we prefer to display using
+tex-fold rather than preview."
   :type '(repeat string))
 
 (defun preview-auto--get-valid-region (beg end search-from-beginning)