From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: emacs-25 f708cb2: Clarify doc string of 'transpose-sexps' Date: Fri, 04 Nov 2016 20:30:38 +0200 Message-ID: <83pombjdwx.fsf@gnu.org> References: <20161104095223.23249.72530@vcs.savannah.gnu.org> <20161104095223.631AB22012D@vcs.savannah.gnu.org> <8737j7e3r5.fsf@gmx.net> <87y40zckn9.fsf@gmx.net> <977b7eaa-1c5f-4d8b-be5d-33ec73f5a962@default> <87twbncgve.fsf@gmx.net> <3687e9ab-658b-49b9-b766-8658d5c48374@default> <87pombceyc.fsf@gmx.net> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1478284276 1395 195.159.176.226 (4 Nov 2016 18:31:16 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 4 Nov 2016 18:31:16 +0000 (UTC) Cc: drew.adams@oracle.com, emacs-devel@gnu.org To: Stephen Berman Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Nov 04 19:31:12 2016 Return-path: Envelope-to: ged-emacs-devel@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 1c2jGb-0007ZG-4y for ged-emacs-devel@m.gmane.org; Fri, 04 Nov 2016 19:31:05 +0100 Original-Received: from localhost ([::1]:40263 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c2jGe-0000Lj-2U for ged-emacs-devel@m.gmane.org; Fri, 04 Nov 2016 14:31:08 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54372) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c2jFo-0000Kh-1D for emacs-devel@gnu.org; Fri, 04 Nov 2016 14:30:18 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c2jFn-00036b-Al for emacs-devel@gnu.org; Fri, 04 Nov 2016 14:30:16 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:40226) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c2jFn-00036O-7u; Fri, 04 Nov 2016 14:30:15 -0400 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:2527 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1c2jFm-0004cJ-HY; Fri, 04 Nov 2016 14:30:14 -0400 In-reply-to: <87pombceyc.fsf@gmx.net> (message from Stephen Berman on Fri, 04 Nov 2016 18:50:03 +0100) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:209167 Archived-At: > From: Stephen Berman > Cc: Eli Zaretskii , emacs-devel@gnu.org > Date: Fri, 04 Nov 2016 18:50:03 +0100 > > If the innermost sexp containing point is a list or string, you cannot > transpose that sexp with another sexp. IMO, this is not useful. The doc string should explain this stuff from the POV of the user who invokes the command. That user always knows which sexps she would like to transpose. That's what I tried to do with my change, by explicitly alluding to the sexps to be transposed. Improvements are welcome, but the above isn't, IMO. Thanks.