From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: Search minibuffer history Date: Mon, 16 Jul 2007 11:49:41 -0400 Message-ID: References: <87myy5thsa.fsf@jurta.org> <87odikbdtl.fsf@jurta.org> <87fy3v7uwp.fsf@jurta.org> <874pka4khu.fsf@jurta.org> <87tzs55t7o.fsf@jurta.org> Reply-To: rms@gnu.org NNTP-Posting-Host: lo.gmane.org Content-Type: text/plain; charset=ISO-8859-15 X-Trace: sea.gmane.org 1184601026 2564 80.91.229.12 (16 Jul 2007 15:50:26 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 16 Jul 2007 15:50:26 +0000 (UTC) Cc: emacs-devel@gnu.org To: Juri Linkov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Jul 16 17:50:22 2007 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1IASq5-0007gY-1D for ged-emacs-devel@m.gmane.org; Mon, 16 Jul 2007 17:50:21 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IASq4-0005Qb-Ks for ged-emacs-devel@m.gmane.org; Mon, 16 Jul 2007 11:50:20 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1IASob-0004jx-79 for emacs-devel@gnu.org; Mon, 16 Jul 2007 11:48:49 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1IASoa-0004jg-Nj for emacs-devel@gnu.org; Mon, 16 Jul 2007 11:48:48 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IASoa-0004jR-7r for emacs-devel@gnu.org; Mon, 16 Jul 2007 11:48:48 -0400 Original-Received: from fencepost.gnu.org ([140.186.70.10]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1IASoZ-0008GV-OQ for emacs-devel@gnu.org; Mon, 16 Jul 2007 11:48:47 -0400 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.60) (envelope-from ) id 1IASpR-00011a-QT; Mon, 16 Jul 2007 11:49:41 -0400 In-reply-to: <87tzs55t7o.fsf@jurta.org> (message from Juri Linkov on Sun, 15 Jul 2007 23:04:43 +0300) X-detected-kernel: Linux 2.6, seldom 2.4 (older, 4) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:74897 Archived-At: It is getting pretty good now, but some of these doc strings need clarification. + (defun minibuffer-history-isearch-end () + "Clean up the minibuffer after terminating an incremental search." That doc string needs to identify the usage more precisely. This is not used after just any isearch, only after a specific kind. + (defun minibuffer-history-isearch-search () + "Return the function for isearch that searches in the minibuffer history." I can't understand that sentence. + (defun minibuffer-history-isearch-message (&optional c-q-hack ellipsis) + "Display the minibuffer history search prompt. + It is either the standard isearch prompt displayed by `isearch-message' + in case of a search error, or an overlay with the isearch prompt displayed + over the original minibuffer prompt in case of successful search." I don't understand "it is either" in that doc string. Are you talking about _how_ this function does its job? If so, please say that explicitly.