From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii 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 18:17:35 +0300 Message-ID: <83in6izrow.fsf@gnu.org> References: <> <<83vaajynvp.fsf@gnu.org>> <9684bd5c-352c-4c83-9d05-e3d339f3e3d6@default> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1529162165 16654 195.159.176.226 (16 Jun 2018 15:16:05 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 16 Jun 2018 15:16:05 +0000 (UTC) Cc: 31790@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Jun 16 17:16:00 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 1fUCvo-0004Au-QU for geb-bug-gnu-emacs@m.gmane.org; Sat, 16 Jun 2018 17:16:00 +0200 Original-Received: from localhost ([::1]:51810 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fUCxv-0001wq-PC for geb-bug-gnu-emacs@m.gmane.org; Sat, 16 Jun 2018 11:18:11 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60891) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fUCxp-0001wa-90 for bug-gnu-emacs@gnu.org; Sat, 16 Jun 2018 11:18:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fUCxm-0003Dg-4s for bug-gnu-emacs@gnu.org; Sat, 16 Jun 2018 11:18:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:43904) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fUCxm-0003DN-1V for bug-gnu-emacs@gnu.org; Sat, 16 Jun 2018 11:18:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fUCxl-0004Xg-Os for bug-gnu-emacs@gnu.org; Sat, 16 Jun 2018 11:18:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 16 Jun 2018 15:18:01 +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.152916227417445 (code B ref 31790); Sat, 16 Jun 2018 15:18:01 +0000 Original-Received: (at 31790) by debbugs.gnu.org; 16 Jun 2018 15:17:54 +0000 Original-Received: from localhost ([127.0.0.1]:51801 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fUCxd-0004XJ-VX for submit@debbugs.gnu.org; Sat, 16 Jun 2018 11:17:54 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:41658) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fUCxc-0004X6-Rm for 31790@debbugs.gnu.org; Sat, 16 Jun 2018 11:17:53 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fUCxU-0002x6-Iv for 31790@debbugs.gnu.org; Sat, 16 Jun 2018 11:17:47 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:37672) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fUCxU-0002wu-Ep; Sat, 16 Jun 2018 11:17:44 -0400 Original-Received: from [176.228.60.248] (port=3843 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1fUCxT-0004cd-MB; Sat, 16 Jun 2018 11:17:44 -0400 In-reply-to: <9684bd5c-352c-4c83-9d05-e3d339f3e3d6@default> (message from Drew Adams on Sat, 16 Jun 2018 06:19:55 -0700 (PDT)) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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:147509 Archived-At: > Date: Sat, 16 Jun 2018 06:19:55 -0700 (PDT) > From: Drew Adams > Cc: 31790@debbugs.gnu.org > > > 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. I don't see how that is evidence to anything. > 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: Those are powerful and flexible commands, it's no wonder their documentation is long. (And 82 lines is not too long in my book.) > But if you don't do that then it is not so easy to pick > up the info about that key binding. And having that in a doc string of a non-user variable will make it easier to pick up? > 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. Like I said, I disagree. Maybe we should provide defcustoms that would initialize the values of these variables. Then it would make sense to tell what you want in those defcustoms' doc strings, like we do with search-invisible, for example.