[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#13923: 24.3.50; doc strings of Isearch commands
From: |
Juri Linkov |
Subject: |
bug#13923: 24.3.50; doc strings of Isearch commands |
Date: |
Tue, 30 Apr 2013 09:54:17 +0300 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/24.3.50 (x86_64-pc-linux-gnu) |
> Does it say that that is a description of NO-RECURSIVE-EDIT? No.
Thanks for bringing attention to endless omissions in docstrings.
> If that is what the intention is, please make the connection, explicitly, so
> user's do not have to guess that that is what you mean.
Does this patch do what you intended to achieve?
=== modified file 'lisp/isearch.el'
--- lisp/isearch.el 2013-04-27 22:03:42 +0000
+++ lisp/isearch.el 2013-04-30 06:54:05 +0000
@@ -735,8 +735,9 @@ (defun isearch-forward (&optional regexp
and are then executed normally (depending on `search-exit-option').
Likewise for function keys and mouse button events.
-If this function is called non-interactively, it does not return to
-the calling function until the search is done."
+If this function is called non-interactively with a nil NO-RECURSIVE-EDIT,
+it does not return to the calling function until the search is done.
+See the function `isearch-mode' for more information."
(interactive "P\np")
(isearch-mode t (not (null regexp-p)) nil (not no-recursive-edit)))
@@ -799,7 +800,23 @@ (defun isearch-backward-regexp (&optiona
(defun isearch-mode (forward &optional regexp op-fun recursive-edit word)
"Start Isearch minor mode.
-It is called by the function `isearch-forward' and other related functions."
+It is called by the function `isearch-forward' and other related functions.
+
+The non-nil arg FORWARD means searching in the forward direction.
+
+The non-nil arg REGEXP does an incremental regular expression search.
+
+The arg OP-FUN is a function to be called after each input character
+is processed. (It is not called after characters that exit the search.)
+
+When the arg RECURSIVE-EDIT is non-nil, this function behaves modally and
+does not return to the calling function until the search is completed.
+To behave this way it enters a recursive-edit and exits it when done
+isearching.
+
+The arg WORD, if t, does incremental search for a sequence of words,
+ignoring punctuation. If the value is a function, it is called to
+convert the search string to a regexp used by regexp search functions."
;; Initialize global vars.
(setq isearch-forward forward