[Emacs-diffs] master 70f83a1 1/2: Add a doc string to redisplay-highlight-region-function

[Lars Ingebrigtsen]

branch: master
commit 70f83a141048c9b6fd119c1999a2113a0ab66e91
Author: Lars Ingebrigtsen <address@hidden>
Commit: Lars Ingebrigtsen <address@hidden>

    Add a doc string to redisplay-highlight-region-function
    
    * lisp/simple.el (redisplay-highlight-region-function): Add a doc
    string (bug#24701).
---
 lisp/simple.el | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/lisp/simple.el b/lisp/simple.el
index 742d6cb..2c6fc84 100644
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -5614,6 +5614,13 @@ separate contiguous regions for each line."
   (lambda (rol) (when (overlayp rol) (delete-overlay rol))))
 
 (defvar redisplay-highlight-region-function
+  "Function to move the highlight overlay.
+This function is called with four parameters, START, END, WINDOW
+and OVERLAY.  If OVERLAY is nil, a new overlay is created.  In
+any case, the overlay is adjusted to reflect the other three
+parameters.
+
+The overlay is returned by the function."
   (lambda (start end window rol)
     (if (not (overlayp rol))
         (let ((nrol (make-overlay start end)))