From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#35498: 26.2; doc string of `isearch-regexp-function' Date: Mon, 29 Apr 2019 18:48:48 -0700 (PDT) Message-ID: <95f9cdd4-4d43-458e-8354-dfc8972b14bf@default> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="111155"; mail-complaints-to="usenet@blaine.gmane.org" To: 35498@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Apr 30 03:50:13 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1hLHuP-000Sn7-EU for geb-bug-gnu-emacs@m.gmane.org; Tue, 30 Apr 2019 03:50:13 +0200 Original-Received: from localhost ([127.0.0.1]:37665 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hLHuO-0003sC-Cd for geb-bug-gnu-emacs@m.gmane.org; Mon, 29 Apr 2019 21:50:12 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:39392) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hLHuF-0003s7-RN for bug-gnu-emacs@gnu.org; Mon, 29 Apr 2019 21:50:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hLHuE-0004Oo-VU for bug-gnu-emacs@gnu.org; Mon, 29 Apr 2019 21:50:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:54933) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hLHuE-0004Oi-RA for bug-gnu-emacs@gnu.org; Mon, 29 Apr 2019 21:50:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hLHuE-0000EI-Hp for bug-gnu-emacs@gnu.org; Mon, 29 Apr 2019 21:50:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 30 Apr 2019 01:50:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 35498 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.1556588950806 (code B ref -1); Tue, 30 Apr 2019 01:50:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 30 Apr 2019 01:49:10 +0000 Original-Received: from localhost ([127.0.0.1]:40243 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hLHtN-0000Cv-R9 for submit@debbugs.gnu.org; Mon, 29 Apr 2019 21:49:10 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:53103) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hLHtL-0000Ci-VM for submit@debbugs.gnu.org; Mon, 29 Apr 2019 21:49:08 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:42389) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hLHtG-0003y7-P0 for submit@debbugs.gnu.org; Mon, 29 Apr 2019 21:49:02 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:39251) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hLHtF-0003pN-Nv for bug-gnu-emacs@gnu.org; Mon, 29 Apr 2019 21:49:02 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hLHtE-0003wS-KX for bug-gnu-emacs@gnu.org; Mon, 29 Apr 2019 21:49:01 -0400 Original-Received: from userp2130.oracle.com ([156.151.31.86]:53768) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hLHtE-0003vI-9t for bug-gnu-emacs@gnu.org; Mon, 29 Apr 2019 21:49:00 -0400 Original-Received: from pps.filterd (userp2130.oracle.com [127.0.0.1]) by userp2130.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x3U1mtMr055618 for ; Tue, 30 Apr 2019 01:48:55 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=eNZ9jAf7u1Y78tVEtwSPHOOAt+CpjsyMNUJIeBgrg7Y=; b=qwuBlCu/Rg7OE04oP6Onoyo5AOdxTnpwTkDgE1KUXZ3yMj56R3D6P2eZmzPOnJLr2xyd OTMN+EpuHvjPZ9uTY0ZRz72c6XPuA2LWPdThdGYe9WCNypeRndmvCRFLivadECsg2hKb i50A2zOxzSMq5io95Jo1FM0QHy36KPDHfr4vSWVlc47Yr7SXpsWF2TASjBOVc4vfVeqj 8ohp8vX4mqMqq2hakBNPTGf7JQYZ1RYF5ILx4lu+okgcWXXZy+19iynQm1hyqCm5KxKU n/Jj4Emf5wv9br/xTONPvTn8T+AQUg+26pe/PWT43A2DQxO3hC5XuexmnhyXcPt81rTy kQ== Original-Received: from aserp3030.oracle.com (aserp3030.oracle.com [141.146.126.71]) by userp2130.oracle.com with ESMTP id 2s5j5txbyk-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 30 Apr 2019 01:48:55 +0000 Original-Received: from pps.filterd (aserp3030.oracle.com [127.0.0.1]) by aserp3030.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x3U1mp06016811 for ; Tue, 30 Apr 2019 01:48:51 GMT Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserp3030.oracle.com with ESMTP id 2s4d4a8b7j-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 30 Apr 2019 01:48:50 +0000 Original-Received: from abhmp0013.oracle.com (abhmp0013.oracle.com [141.146.116.19]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id x3U1mnGc006978 for ; Tue, 30 Apr 2019 01:48:49 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4834.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9242 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=914 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1904300010 X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9242 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=930 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1904300010 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.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: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:158469 Archived-At: The doc string should describe the possible values and their meanings/behaviors. Currently it describes only a function as value. Searching isearch.el it seems that this variable can be any of the values possible for `search-default-mode'. Please describe each of the values for `isearch-regexp-function'. Even when the value is a function the description could be better, saying that it must accept a string as its first arg and must return a string. That can be surmised from saying that it converts a plain search string to a regexp [search string], but it could be clearer. Also, "plain search string" and "regexp" are unclear here. The distinction is presumably (?) that the former contains no regexp special chars? Or does the return value need to be a _valid_ (complete) regexp, and does the function raise an error if that's not possible? In GNU Emacs 26.2 (build 1, x86_64-w64-mingw32) of 2019-04-13 Repository revision: fd1b34bfba8f3f6298df47c8e10b61530426f749 Windowing system distributor `Microsoft Corp.', version 10.0.17134 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''