cape-dabbrev: Improve docstring

1 files changed, 6 insertions, 1 deletions

diff --git a/cape.el b/cape.el
index 0a7214f..3377a21 100644
--- a/cape.el
+++ b/cape.el
@@ -61,7 +61,10 @@
   :type 'string)
 
 (defcustom cape-dabbrev-min-length 4
-  "Minimum length of dabbrev expansions."
+  "Minimum length of dabbrev expansions.
+This setting ensures that words which are too short
+are not offered as completion candidates, such that
+auto completion does not pop up too aggressively."
   :type 'integer)
 
 (defcustom cape-dabbrev-check-other-buffers t
@@ -497,6 +500,8 @@ If INTERACTIVE is nil the function acts like a capf."
 ;;;###autoload
 (defun cape-dabbrev (&optional interactive)
   "Complete with Dabbrev at point.
+See the user options `cape-dabbrev-min-length' and
+`cape-dabbrev-check-other-buffers'.
 If INTERACTIVE is nil the function acts like a capf."
   (interactive (list t))
   (if interactive