From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.devel Subject: Re: Emacs manual nodes about text replacement Date: Mon, 17 Nov 2008 01:27:49 +0200 Organization: JURTA Message-ID: <873ahrnte2.fsf@jurta.org> References: <005801c94752$053e9e50$0200a8c0@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1226878317 31400 80.91.229.12 (16 Nov 2008 23:31:57 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 16 Nov 2008 23:31:57 +0000 (UTC) Cc: emacs-devel@gnu.org To: "Drew Adams" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Nov 17 00:32:57 2008 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1L1r6o-0000m5-Ap for ged-emacs-devel@m.gmane.org; Mon, 17 Nov 2008 00:32:50 +0100 Original-Received: from localhost ([127.0.0.1]:47265 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1L1r5f-000275-U9 for ged-emacs-devel@m.gmane.org; Sun, 16 Nov 2008 18:31:39 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1L1r4i-0001O8-Kh for emacs-devel@gnu.org; Sun, 16 Nov 2008 18:30:40 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1L1r4h-0001NF-4V for emacs-devel@gnu.org; Sun, 16 Nov 2008 18:30:40 -0500 Original-Received: from [199.232.76.173] (port=53688 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1L1r4g-0001NA-VZ for emacs-devel@gnu.org; Sun, 16 Nov 2008 18:30:39 -0500 Original-Received: from relay01.kiev.sovam.com ([62.64.120.200]:4790) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1L1r4g-0004Z9-Fq for emacs-devel@gnu.org; Sun, 16 Nov 2008 18:30:38 -0500 Original-Received: from [83.170.232.243] (helo=smtp.svitonline.com) by relay01.kiev.sovam.com with esmtp (Exim 4.67) (envelope-from ) id 1L1r4e-0008KH-L6; Mon, 17 Nov 2008 01:30:36 +0200 In-Reply-To: <005801c94752$053e9e50$0200a8c0@us.oracle.com> (Drew Adams's message of "Sat, 15 Nov 2008 10:43:15 -0800") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (x86_64-pc-linux-gnu) X-Scanner-Signature: ef6c50392af5ec65634338665e82f3c2 X-DrWeb-checked: yes X-SpamTest-Envelope-From: juri@jurta.org X-SpamTest-Group-ID: 00000000 X-SpamTest-Header: Trusted X-SpamTest-Info: Profiles 5729 [Nov 17 2008] X-SpamTest-Info: {received from trusted relay: common white list} X-SpamTest-Info: {HEADERS: header Content-Type found without required header Content-Transfer-Encoding} X-SpamTest-Method: white ip list X-SpamTest-Rate: 10 X-SpamTest-Status: Trusted X-SpamTest-Status-Extended: trusted X-SpamTest-Version: SMTP-Filter Version 3.0.0 [0278], KAS30/Release X-detected-operating-system: by monty-python.gnu.org: FreeBSD 4.8-5.1 (or MacOS X 10.2-10.3) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:105732 Archived-At: > The presentation and order of the manual nodes describing text replacement could > be improved. I don't have a concrete proposal, but here are some problems I see. > > The main node, Replace, starts by saying that you don't use global > search-and-replace that much in Emacs. That's true in the batch (unconditional) > sense, but query-replacement is commonly used. This could be made clearer: > Unconditional global replacement is not needed that often. Most of the time you > use conditional, interactive replacement - called query-replacement. I can't find none of the text that you are referring to. What version do you use? Recently Yidong rewrote many parts of the documentation, so please refer to a newer version. -- Juri Linkov http://www.jurta.org/emacs/