From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: charles@aurox.ch (Charles A. Roelli) Newsgroups: gmane.emacs.bugs Subject: bug#32990: 26.1.50; isearch-forward + t-m-m/mark-active doc Date: Sat, 10 Nov 2018 14:57:43 +0100 Message-ID: References: <83muroyzfk.fsf@gnu.org> <83woqrx9pt.fsf@gnu.org> <835zy3tfrb.fsf@gnu.org> <83bm7pueej.fsf@gnu.org> <834ld6m5jk.fsf@gnu.org> Reply-To: charles@aurox.ch NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1541858458 17595 195.159.176.226 (10 Nov 2018 14:00:58 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 10 Nov 2018 14:00:58 +0000 (UTC) Cc: 32990@debbugs.gnu.org To: eliz@gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Nov 10 15:00:54 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 1gLToh-0004QU-EL for geb-bug-gnu-emacs@m.gmane.org; Sat, 10 Nov 2018 15:00:51 +0100 Original-Received: from localhost ([::1]:38584 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gLTqn-0005Bs-W7 for geb-bug-gnu-emacs@m.gmane.org; Sat, 10 Nov 2018 09:03:02 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:39328) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gLTl2-0007UN-NC for bug-gnu-emacs@gnu.org; Sat, 10 Nov 2018 08:57:08 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gLTl1-00052X-PM for bug-gnu-emacs@gnu.org; Sat, 10 Nov 2018 08:57:04 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:40013) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gLTl1-00052R-L6 for bug-gnu-emacs@gnu.org; Sat, 10 Nov 2018 08:57:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1gLTl0-0005qa-DU for bug-gnu-emacs@gnu.org; Sat, 10 Nov 2018 08:57:03 -0500 X-Loop: help-debbugs@gnu.org Resent-From: charles@aurox.ch (Charles A. Roelli) Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 10 Nov 2018 13:57:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 32990 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 32990-submit@debbugs.gnu.org id=B32990.154185821422457 (code B ref 32990); Sat, 10 Nov 2018 13:57:02 +0000 Original-Received: (at 32990) by debbugs.gnu.org; 10 Nov 2018 13:56:54 +0000 Original-Received: from localhost ([127.0.0.1]:44271 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gLTkr-0005q9-Mq for submit@debbugs.gnu.org; Sat, 10 Nov 2018 08:56:53 -0500 Original-Received: from sinyavsky.aurox.ch ([37.35.109.145]:56378) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gLTkp-0005pu-T7 for 32990@debbugs.gnu.org; Sat, 10 Nov 2018 08:56:52 -0500 Original-Received: from sinyavsky.aurox.ch (sinyavsky.aurox.ch [127.0.0.1]) by sinyavsky.aurox.ch (Postfix) with ESMTP id EB39422995 for <32990@debbugs.gnu.org>; Sat, 10 Nov 2018 14:01:21 +0000 (UTC) Authentication-Results: sinyavsky.aurox.ch (amavisd-new); dkim=pass reason="pass (just generated, assumed good)" header.d=aurox.ch DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=aurox.ch; h= references:reply-to:subject:subject:in-reply-to:to:from:from :message-id:date:date; s=dkim; t=1541858480; x=1542722481; bh=qE TZpmhvKd4mXQ2cBnIgIBUULMBnbHYnWnK4gQMt/Ck=; b=MwbczZF4OVhaa/Qdb1 Mu4zh8jQ7SPyKKfw0RBVFn0L9t/p6Oy3cqr5VaupbfnsstR4mx/ai/6BLqwlXrDw jberO4MKYObASUb8tteZQszuYHPuS6fnmePdGedqN224vUVM8pLLnBjYbbEcMZUh ABvvQgvMqeziUFX8V5CMTBOnY= X-Virus-Scanned: Debian amavisd-new at test.virtualizor.com Original-Received: from sinyavsky.aurox.ch ([127.0.0.1]) by sinyavsky.aurox.ch (sinyavsky.aurox.ch [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id I4MyHos_SFcT for <32990@debbugs.gnu.org>; Sat, 10 Nov 2018 14:01:20 +0000 (UTC) Original-Received: from gray (unknown [IPv6:2a02:1205:34ff:bc50:c62c:3ff:fe30:b864]) by sinyavsky.aurox.ch (Postfix) with ESMTPSA id 8984B22181; Sat, 10 Nov 2018 14:01:20 +0000 (UTC) In-reply-to: (charles@aurox.ch) 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:152248 Archived-At: Now that we have all of the important isearch commands and bindings indexed, we should be able to shorten isearch-forward's docstring. The question is, how much? Here's one attempt that may cut out too much: "Do incremental search forward for a string as you type. \\ \\[isearch-repeat-forward] moves forward to the next search hit. \\[isearch-repeat-backward] moves backward to the previous search hit. \\[isearch-abort] aborts the search and returns point to its former position. \\[isearch-exit] exits the search and leaves point where it is. Many other non-printing keys have special bindings while searching; Info node `(emacs)Incremental Search' and its descendants describes them. If REGEXP-P is non-nil (or interactively, when called with a prefix argument), do an incremental regular expression search instead. If NO-RECURSIVE-EDIT is non-nil (as it is interactively), do not enter a recursive edit. If nil, enter a recursive edit and exit the recursive edit when the search is done." It covers the absolute basics, but leaves everything else to the manual. I'm not sure all users will like that, since the current docstring covers almost all of the keybindings. I remember reading somewhere a suggestion for adding a toolbar (and (or) a dedicated menu) for use during isearch-mode, to help the discoverability of these myriad keybindings. That could be a good alternative to listing verbosely every binding in the docstring.