From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Kevin Rodgers Newsgroups: gmane.emacs.bugs Subject: Re: Documentation bug for isearch? Date: Tue, 30 Jan 2007 23:00:16 -0700 Message-ID: References: <87sldsb56i.fsf@free.fr> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Trace: sea.gmane.org 1170223253 10161 80.91.229.12 (31 Jan 2007 06:00:53 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 31 Jan 2007 06:00:53 +0000 (UTC) To: bug-gnu-emacs@gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Jan 31 07:00:37 2007 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.50) id 1HC8WH-0000Ro-6R for geb-bug-gnu-emacs@m.gmane.org; Wed, 31 Jan 2007 07:00:33 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HC8WG-0003Z0-Q5 for geb-bug-gnu-emacs@m.gmane.org; Wed, 31 Jan 2007 01:00:32 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1HC8WD-0003Yv-Gp for bug-gnu-emacs@gnu.org; Wed, 31 Jan 2007 01:00:29 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1HC8WB-0003Yj-Mg for bug-gnu-emacs@gnu.org; Wed, 31 Jan 2007 01:00:28 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HC8WB-0003Yg-Ac for bug-gnu-emacs@gnu.org; Wed, 31 Jan 2007 01:00:27 -0500 Original-Received: from main.gmane.org ([80.91.229.2] helo=ciao.gmane.org) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA:32) (Exim 4.52) id 1HC8WA-0005uV-RJ for bug-gnu-emacs@gnu.org; Wed, 31 Jan 2007 01:00:27 -0500 Original-Received: from list by ciao.gmane.org with local (Exim 4.43) id 1HC8Vz-0003NP-Hl for bug-gnu-emacs@gnu.org; Wed, 31 Jan 2007 07:00:15 +0100 Original-Received: from c-24-9-156-178.hsd1.co.comcast.net ([24.9.156.178]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 31 Jan 2007 07:00:15 +0100 Original-Received: from kevin.d.rodgers by c-24-9-156-178.hsd1.co.comcast.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 31 Jan 2007 07:00:15 +0100 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 30 Original-X-Complaints-To: usenet@sea.gmane.org X-Gmane-NNTP-Posting-Host: c-24-9-156-178.hsd1.co.comcast.net User-Agent: Thunderbird 1.5.0.9 (Macintosh/20061207) In-Reply-To: <87sldsb56i.fsf@free.fr> X-detected-kernel: Linux 2.6, seldom 2.4 (older, 4) X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list 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:15567 Archived-At: Matthieu Lemerre wrote: > I use Emacs for more than 7 year and I just found out that C-s sets > the mark automatically when you start an isearch. The problem with > Emacs is that it's so long to use it optimally, that you get used to > bad automatisms :) > > This fact is not written in the documentation string for > isearch-forward; there is a hint "Mark saved where search started", > but I tend not to see them using emacs in full-screen; > > I think I would have found it earlier if I could have read it in the > doc string of isearch; my suggestion is to put it in the doc string. Actually, the mark is set when you _exit_ isearch, as explained in the Emacs manual: ,---- | When you exit the incremental search, it sets the mark where point | _was_ before the search. That is convenient for moving back there. In | Transient Mark mode, incremental search sets the mark without | activating it, and does so only if the mark is not already active. `---- I think that text is too long to include in the doc string of the various isearch commands, and shortening it would leave out the really useful information. -- Kevin Rodgers Denver, Colorado, USA