From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Alan Mackenzie Newsgroups: gmane.emacs.devel Subject: Re: Documentation of transient-mark-mode is sloppy, wrong, and confused. Date: Fri, 29 May 2009 09:35:33 +0000 Message-ID: <20090529093533.GC2793@muc.de> References: <20090528122927.GA2175@muc.de> <87fxepf9s8.fsf@cyd.mit.edu> <20090528201529.GA4605@muc.de> <87bppdx8c0.fsf@cyd.mit.edu> <20090528230359.GA1474@muc.de> <83y6sgqp6l.fsf@gnu.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1243589846 14431 80.91.229.12 (29 May 2009 09:37:26 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 29 May 2009 09:37:26 +0000 (UTC) Cc: cyd@stupidchicken.com, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri May 29 11:37:22 2009 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 1M9yWg-0006Oq-9k for ged-emacs-devel@m.gmane.org; Fri, 29 May 2009 11:37:22 +0200 Original-Received: from localhost ([127.0.0.1]:36629 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1M9yWf-0005uJ-JZ for ged-emacs-devel@m.gmane.org; Fri, 29 May 2009 05:37:21 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1M9yU9-0004f0-Ud for emacs-devel@gnu.org; Fri, 29 May 2009 05:34:46 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1M9yU4-0004bu-JH for emacs-devel@gnu.org; Fri, 29 May 2009 05:34:44 -0400 Original-Received: from [199.232.76.173] (port=53755 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1M9yU4-0004bm-6g for emacs-devel@gnu.org; Fri, 29 May 2009 05:34:40 -0400 Original-Received: from colin.muc.de ([193.149.48.1]:2110 helo=mail.muc.de) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1M9yU3-0003xU-KI for emacs-devel@gnu.org; Fri, 29 May 2009 05:34:39 -0400 Original-Received: (qmail 41140 invoked by uid 3782); 29 May 2009 09:34:38 -0000 Original-Received: from acm.muc.de (pD9E514E9.dip.t-dialin.net [217.229.20.233]) by colin2.muc.de (tmda-ofmipd) with ESMTP; Fri, 29 May 2009 11:34:36 +0200 Original-Received: (qmail 4088 invoked by uid 1000); 29 May 2009 09:35:33 -0000 Content-Disposition: inline In-Reply-To: <83y6sgqp6l.fsf@gnu.org> User-Agent: Mutt/1.5.9i X-Delivery-Agent: TMDA/1.1.5 (Fettercairn) X-Primary-Address: acm@muc.de X-detected-operating-system: by monty-python.gnu.org: FreeBSD 4.6-4.9 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:111188 Archived-At: Hi, Eli! On Fri, May 29, 2009 at 11:38:26AM +0300, Eli Zaretskii wrote: > > Date: Thu, 28 May 2009 23:03:59 +0000 > > From: Alan Mackenzie > > Cc: emacs-devel@gnu.org > > > The main thing that's important, I think, is that the description > > > of the "transient-mark-mode enabled" behavior and the > > > "transient-mark-mode disabled" behavior are each internally > > > consistent; they aren't always mutually consistent, but that's too > > > bad. > > Manuals shouldn't be patronising. When a manual implicitly says "if > > you can't even figure out what I mean by \"active\", you're stupid", > > that's patronising. > Did the manual actually say that? where? No, it didn't _actually_ say that, it _implicitly_ said it; or, more precisely, that's the message I would hear if I were an Emacs user trying to make sense of that page of the manual. -- Alan Mackenzie (Nuremberg, Germany).