From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#8101: 24.0.50; `isearch-search-fun-function' Date: Wed, 23 Feb 2011 10:10:30 -0800 Message-ID: <66E24FAF136B4253A30F2F2BCB567FBB@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1298486227 19676 80.91.229.12 (23 Feb 2011 18:37:07 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 23 Feb 2011 18:37:07 +0000 (UTC) To: 8101@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Feb 23 19:37:00 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PsJa6-0008Md-UC for geb-bug-gnu-emacs@m.gmane.org; Wed, 23 Feb 2011 19:36:59 +0100 Original-Received: from localhost ([127.0.0.1]:32925 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PsJa6-0001tp-8y for geb-bug-gnu-emacs@m.gmane.org; Wed, 23 Feb 2011 13:36:58 -0500 Original-Received: from [140.186.70.92] (port=51937 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PsJZu-0001qz-Oq for bug-gnu-emacs@gnu.org; Wed, 23 Feb 2011 13:36:47 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PsJZt-0004Wo-Jm for bug-gnu-emacs@gnu.org; Wed, 23 Feb 2011 13:36:46 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:34898) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PsJZt-0004Wk-Gu for bug-gnu-emacs@gnu.org; Wed, 23 Feb 2011 13:36:45 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1PsJB0-0004NC-AW; Wed, 23 Feb 2011 13:11:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 23 Feb 2011 18:11:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 8101 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.129848465616780 (code B ref -1); Wed, 23 Feb 2011 18:11:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 23 Feb 2011 18:10:56 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PsJAt-0004MZ-3l for submit@debbugs.gnu.org; Wed, 23 Feb 2011 13:10:55 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PsJAr-0004MA-Vs for submit@debbugs.gnu.org; Wed, 23 Feb 2011 13:10:54 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PsJAm-0008G5-0A for submit@debbugs.gnu.org; Wed, 23 Feb 2011 13:10:48 -0500 Original-Received: from lists.gnu.org ([199.232.76.165]:45367) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PsJAl-0008G1-Tr for submit@debbugs.gnu.org; Wed, 23 Feb 2011 13:10:47 -0500 Original-Received: from [140.186.70.92] (port=55359 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PsJAk-0003rD-JB for bug-gnu-emacs@gnu.org; Wed, 23 Feb 2011 13:10:47 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PsJAj-0008FD-AQ for bug-gnu-emacs@gnu.org; Wed, 23 Feb 2011 13:10:46 -0500 Original-Received: from rcsinet10.oracle.com ([148.87.113.121]:32837) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PsJAj-0008Dw-5G for bug-gnu-emacs@gnu.org; Wed, 23 Feb 2011 13:10:45 -0500 Original-Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id p1NIAeud008163 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 23 Feb 2011 18:10:42 GMT Original-Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154]) by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id p1NEJnNr011719 for ; Wed, 23 Feb 2011 18:10:40 GMT Original-Received: from abhmt021.oracle.com by acsmt353.oracle.com with ESMTP id 1031634181298484629; Wed, 23 Feb 2011 10:10:29 -0800 Original-Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 23 Feb 2011 10:10:29 -0800 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcvThPRxGuv9lVsGSJ25dLrBnsc4Aw== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5994 X-Source-IP: acsmt354.oracle.com [141.146.40.154] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090207.4D654DA0.00A5:SCFMA4539814,ss=1,fgs=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Wed, 23 Feb 2011 13:11:02 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:44318 Archived-At: Doc string is broken: "Override `isearch-search-fun'. This function should return the search function for Isearch to use. It will call this function with three arguments as if it were `search-forward'." First line is incorrect. It overrides the default search function which is used by `isearch-search-string', but it does not override `isearch-search-fun'. It is *called* from `isearch-search-fun', so it certainly cannot override it. The biggest problem is the last sentence. "It will call this function" What is "IT"? What is "THIS FUNCTION"? And why mention `search-forward' here? Very confusing, if not downright incorrect. Make it clear that this var's value is a function that is called with NO ARGS and whose return value should be a function of the SAME THREE ARGS as `isearch-search-string'. That returned function will be used by `isearch-search-string' to "search for the first occurrence of STRING or its translation." Further, the doc string of `isearch-search-fun' should also say that the function returned accepts the same three args as `isearch-search-string' - and so on. In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600) of 2011-02-14 on 3249CTO Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.4) --no-opt --cflags -Ic:/imagesupport/include'