From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Stephen Berman Newsgroups: gmane.emacs.devel Subject: Re: emacs-25 f708cb2: Clarify doc string of 'transpose-sexps' Date: Fri, 04 Nov 2016 18:08:37 +0100 Message-ID: <87twbncgve.fsf@gmx.net> 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> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1478279374 10968 195.159.176.226 (4 Nov 2016 17:09:34 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 4 Nov 2016 17:09:34 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.0.50 (gnu/linux) Cc: Eli Zaretskii , emacs-devel@gnu.org To: Drew Adams Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Nov 04 18:09:30 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 1c2hzb-00027S-VN for ged-emacs-devel@m.gmane.org; Fri, 04 Nov 2016 18:09:28 +0100 Original-Received: from localhost ([::1]:40014 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c2hze-00062h-PO for ged-emacs-devel@m.gmane.org; Fri, 04 Nov 2016 13:09:30 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:47981) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c2hyy-00062L-HZ for emacs-devel@gnu.org; Fri, 04 Nov 2016 13:08:49 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c2hyx-0008JE-JK for emacs-devel@gnu.org; Fri, 04 Nov 2016 13:08:48 -0400 Original-Received: from mout.gmx.net ([212.227.17.20]:60168) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1c2hyt-0008Aw-Ps; Fri, 04 Nov 2016 13:08:44 -0400 Original-Received: from rosalinde ([89.245.89.33]) by mail.gmx.com (mrgmx103) with ESMTPSA (Nemesis) id 0MVNWU-1cLxIB3ZOw-00YhoO; Fri, 04 Nov 2016 18:08:38 +0100 In-Reply-To: <977b7eaa-1c5f-4d8b-be5d-33ec73f5a962@default> (Drew Adams's message of "Fri, 4 Nov 2016 09:44:30 -0700 (PDT)") X-Provags-ID: V03:K0:IPV7sP1pUwDXQjSZOIqPiIBb3mBdvna84YnupVvLeWgEuXe8QLx QlY/4wgG90RjatzIBXMXFASZQR4H1667HHIVxSadxDw9bs0CVh7NkxoSvS5e3WH5DxTKFGq kXzprG8F7wdpXz4f5QGUJKfzDH9cc0XZ66vVF+zVql3lVVbJ5kARyZXx2hqojiWY+eq5RMt Jumk9fILXTAj32BNxj/7g== X-UI-Out-Filterresults: notjunk:1;V01:K0:wEJfK2GUU5Y=:6XySDEHh5X1+AlfX2To6W3 XO+zQgY7DoHp3vyKmnchzdhuNlSHMhVkNIpCGE1P9XH6rF8IKWW2111Ad2RgaO5QsD6GtJ8M/ Qe/Bw3mJTYIRlHtPwm9pOncTjFaWn0HuNiDxT/+DVK+PB9Usg7RwV0+jRG+UJbFlf1pPCeZsK XiITVLA0sOHgZertlTdkfrK69ndtOUUxxhOGW2iAG4PQR8oP7bQGpX976gOx/W/BXaIORH6RZ F3o6EFfRowWb5xZHfO6Wzm2RLrX5f7mDlewlfY1wbUk8lNCJkFdj6pJYw1/y2uAduUnXegLSO c6wS75v2kjObi61rAB+KIZf829GnoyFkMBngPf2y1pTCxAQBf86UuagM/C6X3DfE43oqBNveV 3j3BruAlAuROR17jqLWBt5aon23v4FVTVgYGP0K5f/3ZuV5WXeN/wQ4A27qGCyqFWzxKNLJO1 dmOX5cnxMQvWq6VaWKKmUM3KnhDYL9NbV2LWbBcWiL/fWl7MOO+ds0B3IvdfTLgOphKBo/v65 KjvtyaNptnd0OSTVg0pllbWFNcHSjCEx63lWGVtsAjjzH4OPRSlU1+iMXJR8h5avegTb9dCbw it3DaZcBH1aVFTX+7zuJbiIIr1Cxbb4Ofbz/D8zCxUkiFLt0rZtRA3sx6uebqvmP1l5Bu/y9/ tEmqFjQ1ND5FfScTPmBYDEyAd9E0CR92hLReqVVL9sjPYFcLXCR/0oFV4oZX/W4AuugAqm81O Xav4bIFEXIxzt4XqrSRk0h0cRQrsSjLhGmZFRLT8mzzzaljR/+qF1Lz9Q2Lni5VpDEcA8oyt X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 212.227.17.20 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:209157 Archived-At: On Fri, 4 Nov 2016 09:44:30 -0700 (PDT) Drew Adams wrote: >> > 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. >> >> 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". I think that's unnecessary if this is a "reasonable interpretation", i.e. it's common sense, so making it explicit tends to be pedantic. Do you really think this is not the common sense way of understanding it? If so, I guess you have a function in mind that behaves differently; which one? Steve Berman