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:50:03 +0100 Message-ID: <87pombceyc.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> <87twbncgve.fsf@gmx.net> <3687e9ab-658b-49b9-b766-8658d5c48374@default> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1478281903 27542 195.159.176.226 (4 Nov 2016 17:51:43 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 4 Nov 2016 17:51:43 +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:51:38 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 1c2idm-00025S-Cp for ged-emacs-devel@m.gmane.org; Fri, 04 Nov 2016 18:50:58 +0100 Original-Received: from localhost ([::1]:40151 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c2idp-0004yx-8f for ged-emacs-devel@m.gmane.org; Fri, 04 Nov 2016 13:51:01 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:37353) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c2id7-0004ug-J6 for emacs-devel@gnu.org; Fri, 04 Nov 2016 13:50:18 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c2id6-0004CU-7S for emacs-devel@gnu.org; Fri, 04 Nov 2016 13:50:17 -0400 Original-Received: from mout.gmx.net ([212.227.17.20]:55305) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1c2id1-000447-FD; Fri, 04 Nov 2016 13:50:11 -0400 Original-Received: from rosalinde ([89.245.89.33]) by mail.gmx.com (mrgmx101) with ESMTPSA (Nemesis) id 0LnCkb-1cUMwT3Noz-00hO2x; Fri, 04 Nov 2016 18:50:04 +0100 In-Reply-To: <3687e9ab-658b-49b9-b766-8658d5c48374@default> (Drew Adams's message of "Fri, 4 Nov 2016 10:21:36 -0700 (PDT)") X-Provags-ID: V03:K0:whDqQ5O+LdfnfQUcBs71aaRbiXQ3alIn/tfLSehSgCODWvxb6Tu VIvH+f+F62dLz6TIV8Kv+oCc7InQKghQR/IVgIuitZSP6lNs2YZx24WhZhA0Yw/pzLwDUxi o3DDD9jq/qmr5jasJGjBK5DvFWU4NV5NHlZjaGuoWg/TDenrncdIikgVqoQ8ngPZo2rvNxX PckQ8VihzCpM1G/cUK8og== X-UI-Out-Filterresults: notjunk:1;V01:K0:AKf96YClqRc=:tU+MrSaZuav7kTxQnHWSbJ eYTPcC//G0VrdfAuzNcd/hGcMBnpYECOMr9bIgd5zO+tyQ6vdGHVe2+ddR1vJaGtFoqS2GZoX VvOjXQCZS45WWxd9JfgOj1Wg2fzPOUlc8x4HNQnWBnolXkUKBTd62MMS+MtX9lT8SmezP4XF3 U1c+NZT4fx49Wf72hFdoRBY1+Xiv0z/LwN6jHLXjxnZFy0EflPauid8oY5cPxdcN0IaNwzT/O 1qeUJhUQxaPJaaIsHsVneZqbppFLdOxhxnhpHeyU6TkkNFBkPlEnt8b1vewv5vo4h1y1yCJkh 4yHH8JPWyXAp+gBCtL75n/zLdZeWNhbBfC0dQWaT0pCqKz6lUCqdq4eBHQxj0CNTu3YWMDto5 TVkzgcxbNQF3g5ouIXKawbB7zW+NjkkmrgX2cPihLeHdi8+UlARTgrIFjxbjPbOhUAti6fAZU ZEbpaq8SL1fiJNF9F+W1POwTEJzwJXAtjWmeIyekyXzyjYlbeYkPem0MZtbCNnsL1A9o+ww3r 6Vs+0z8KPkNp0YNQlm4UVOv5mtG7X0MCSvzT+yXpQ4wiB3oGQD0deIdrqQ/7CpKpeouz73Dwn wMTAW7PCzXtXSOW39wj0trlTSti8rhdhADSAoWU0S1NNNDOfuT2CuD7PxRZN3zaO9kpFc1VaF xe4jO0nU5tDjC5ecF1s83yB59385Yzx9KgJvB8qk0ehWZg+VYuoq8fmZVqtq9R/brW3/jJvdB zvueRRKxBSh9yY2WyRDB9jVXjmHBNmV2pjGAoivcXQQeLSfYnbx4319dbb2NcDQlDzS0t/lP 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:209160 Archived-At: On Fri, 4 Nov 2016 10:21:36 -0700 (PDT) Drew Adams wrote: > It is not unreasonable to be clear and brief. I repeat: > if the doc means "the innermost sexp containing point" then > it should just say that. That's not being pedantic; it's > being clear. So is the following (combining Eli's changes with my correction and your clarification) then clear enough? "Like \\[transpose-chars] (`transpose-chars'), but applies to sexps. If the innermost sexp containing point is a list or string, you cannot transpose that sexp with another sexp. With non-zero prefix arg ARG, effect is to take the sexp before point and drag it forward past ARG other sexps (backward if ARG is negative). If ARG is zero, the sexps ending at or after point and at or after mark are interchanged." Steve Berman