From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#31790: 27.0; Mention Isearch key bindings of Isedarch variables that are bound by default in Isearch Date: Sat, 16 Jun 2018 06:19:55 -0700 (PDT) Message-ID: <9684bd5c-352c-4c83-9d05-e3d339f3e3d6@default> References: <> <<83vaajynvp.fsf@gnu.org>> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1529155152 2102 195.159.176.226 (16 Jun 2018 13:19:12 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 16 Jun 2018 13:19:12 +0000 (UTC) Cc: 31790@debbugs.gnu.org To: Eli Zaretskii , Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Jun 16 15:19:08 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fUB6h-0000ND-Ok for geb-bug-gnu-emacs@m.gmane.org; Sat, 16 Jun 2018 15:19:08 +0200 Original-Received: from localhost ([::1]:51577 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fUB8n-0000Ln-3A for geb-bug-gnu-emacs@m.gmane.org; Sat, 16 Jun 2018 09:21:17 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:46453) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fUB8b-0000LZ-Ue for bug-gnu-emacs@gnu.org; Sat, 16 Jun 2018 09:21:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fUB8Y-0005kc-PR for bug-gnu-emacs@gnu.org; Sat, 16 Jun 2018 09:21:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:43219) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fUB8Y-0005kX-L5 for bug-gnu-emacs@gnu.org; Sat, 16 Jun 2018 09:21:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fUB8Y-00081z-CS for bug-gnu-emacs@gnu.org; Sat, 16 Jun 2018 09:21: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: Sat, 16 Jun 2018 13:21:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 31790 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 31790-submit@debbugs.gnu.org id=B31790.152915520730775 (code B ref 31790); Sat, 16 Jun 2018 13:21:02 +0000 Original-Received: (at 31790) by debbugs.gnu.org; 16 Jun 2018 13:20:07 +0000 Original-Received: from localhost ([127.0.0.1]:51116 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fUB7e-00080H-Ig for submit@debbugs.gnu.org; Sat, 16 Jun 2018 09:20:06 -0400 Original-Received: from userp2120.oracle.com ([156.151.31.85]:54696) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fUB7c-0007zi-VN for 31790@debbugs.gnu.org; Sat, 16 Jun 2018 09:20:05 -0400 Original-Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w5GDJwFG108661; Sat, 16 Jun 2018 13:19:58 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2017-10-26; bh=cJDPn5gvBOU7FYFvnxEmiVsM9NwMVNfD9e+xrGvmh3M=; b=svb8NxlnaLPqQyNzlNcUmN8nCabtQsxv0ClEDQkVE+NxUEb8YYKjVcy1Jkl39XkcUtHz JNSe07GfjSuxPT7AXVUbweVyXtz9Zgb1nzj7N7CODE7D8u4WDB1NrAHD3uAXEni9GVG9 hpOSh5urzlpKaYXR3X1p2S08zaZe9BuYn7v8oL+dW4Tuz8tY7QuvXEpAyatV/jBPptKk cS6IbiyPGQ6TelxzzZbFwPGRB5qNG5igrD3RKwWNAw3JBP5+wgAP0/llJlmyr6V4LTIi E5s94W2lEiEXqtOOaClt98G6rM3XYDunao2AYHi+3EMGGv7vvVowGf4lcmCo6yrbujAD 7Q== Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by userp2120.oracle.com with ESMTP id 2jmu6xghx8-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 16 Jun 2018 13:19:58 +0000 Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserv0022.oracle.com (8.14.4/8.14.4) with ESMTP id w5GDJvOk003053 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 16 Jun 2018 13:19:57 GMT Original-Received: from abhmp0008.oracle.com (abhmp0008.oracle.com [141.146.116.14]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id w5GDJu5A030793; Sat, 16 Jun 2018 13:19:57 GMT In-Reply-To: <<83vaajynvp.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4690.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=8925 signatures=668702 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=779 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1805220000 definitions=main-1806160162 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: 208.118.235.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:147500 Archived-At: > > `C-h v isearch(-regexp)-lax-whitespace' tells you that command > > `isearch-toggle-lax-whitespace' toggles the variable. But it does not > > tell you that this command is bound, by default, to `M-s SPC' during > > Isearch. > > > > It should tell you that. (It is not so easy to discover the binding.) >=20 > Those are variables, not defcustoms. Why is it important to go to > such lengths in their doc strings? Go to such lengths? Really? See https://emacs.stackexchange.com/q/41960/105. Sure, if you consult the doc of `isearch-forward(-regexp)' or its keys, and you read it all, then when you get to line 43 (out of 82!) you'll find the info you're looking for wrt lax-vs-strict whitespace matching: Type M-s SPC to toggle whitespace matching. In incremental searches, a space or spaces normally matches any=20 whitespace defined by the variable 'search-whitespace-regexp'; see also the variables 'isearch-lax-whitespace' and 'isearch-regexp-lax-whitespace'. But if you don't do that then it is not so easy to pick up the info about that key binding. And even that text does not make clear what the latter two vars do. To discover how to change the default behavior you need to actually click those var names and consult their doc. And yes, setting or binding those two vars really is the way to go, to set your preferred default behavior. We provide `search-whitespace-regexp' as a user option, but not the other two variables, which are more commonly set by users to govern whitespace matching for search. Yes, we don't let those vars be options because of the Emacs policy that code should not modify option values (even the code for built-in toggles!). It's an unfortunate policy, IMHO, but it is what it is. It just makes sense to point out, in the doc for these two variables that, by default, `M-s SPC' toggles them while searching. If providing that info to users is too much trouble ("go to such lengths"?), then ... please don't bother.