From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: RE: emacs-25 f708cb2: Clarify doc string of 'transpose-sexps' Date: Fri, 4 Nov 2016 09:44:30 -0700 (PDT) Message-ID: <977b7eaa-1c5f-4d8b-be5d-33ec73f5a962@default> References: <20161104095223.23249.72530@vcs.savannah.gnu.org> <20161104095223.631AB22012D@vcs.savannah.gnu.org> <8737j7e3r5.fsf@gmx.net> <87y40zckn9.fsf@gmx.net> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1478277918 23782 195.159.176.226 (4 Nov 2016 16:45:18 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 4 Nov 2016 16:45:18 +0000 (UTC) Cc: Eli Zaretskii , emacs-devel@gnu.org To: Stephen Berman Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Nov 04 17:45:13 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 1c2hbk-0002s8-Iy for ged-emacs-devel@m.gmane.org; Fri, 04 Nov 2016 17:44:48 +0100 Original-Received: from localhost ([::1]:39914 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c2hbn-0002Vd-3X for ged-emacs-devel@m.gmane.org; Fri, 04 Nov 2016 12:44:51 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38877) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c2hbe-0002Uc-Ac for emacs-devel@gnu.org; Fri, 04 Nov 2016 12:44:43 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c2hbd-0004oi-G5 for emacs-devel@gnu.org; Fri, 04 Nov 2016 12:44:42 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:38097) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1c2hbY-0004iw-QY; Fri, 04 Nov 2016 12:44:36 -0400 Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id uA4GiWJs025658 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 4 Nov 2016 16:44:32 GMT Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by userv0021.oracle.com (8.14.4/8.14.4) with ESMTP id uA4GiV6p017154 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 4 Nov 2016 16:44:32 GMT Original-Received: from abhmp0019.oracle.com (abhmp0019.oracle.com [141.146.116.25]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id uA4GiVg1026546; Fri, 4 Nov 2016 16:44:31 GMT In-Reply-To: <87y40zckn9.fsf@gmx.net> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 12.0.6753.5000 (x86)] X-Source-IP: userv0021.oracle.com [156.151.31.71] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-Received-From: 156.151.31.81 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:209154 Archived-At: > > What does it mean to be in the middle of a list, for example? > > A case mentioned in the bug report is this: > > > >>> When point is in the middle of a list it can also be between two > >>> sexps, which themselves could be lists: ((foo)|(bar)), with > >>> point at |. > > > > Point here is in the middle of the outer list, but it is between > > the two inner lists. Any text description needs to be more careful > > and explicit, if it really wants to make the point clear. >=20 > I think a reasonable interpretation of "in the middle of a sexp" is > that the relevant sexp What "relevant sexp"? To say that point is in the middle of a sexp does not imply that it is in the middle of only one sexp. There might be any number of such in-the-middle-of, "relevant" sexps. > is the one whose start and end are closer to point (counting > leftwards and rightwards from point, respectively) than those > of any other sexp. If that's what is meant then that's what the doc should say: "the innermost sexp containing point".