From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.help Subject: RE: Transposing words over middle words Date: Fri, 17 Nov 2017 08:21:30 -0800 (PST) Message-ID: References: <20171115155650067497545@bob.proulx.com> <87vaia9e9v.fsf@mbork.pl> <86d14h6hy1.fsf@zoho.com> <8cc45c1a-d640-4841-9179-b756f2694271@default> <86zi7l4ypn.fsf@zoho.com> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1510935764 18118 195.159.176.226 (17 Nov 2017 16:22:44 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 17 Nov 2017 16:22:44 +0000 (UTC) To: Emanuel Berg , help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Fri Nov 17 17:22:35 2017 Return-path: Envelope-to: geh-help-gnu-emacs@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 1eFjPN-0003fX-IL for geh-help-gnu-emacs@m.gmane.org; Fri, 17 Nov 2017 17:22:25 +0100 Original-Received: from localhost ([::1]:46680 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eFjPV-0002mz-0D for geh-help-gnu-emacs@m.gmane.org; Fri, 17 Nov 2017 11:22:33 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59629) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eFjOg-0002jT-Jn for help-gnu-emacs@gnu.org; Fri, 17 Nov 2017 11:21:43 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eFjOa-00038t-VR for help-gnu-emacs@gnu.org; Fri, 17 Nov 2017 11:21:42 -0500 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:31127) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1eFjOa-00037q-OT for help-gnu-emacs@gnu.org; Fri, 17 Nov 2017 11:21:36 -0500 Original-Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id vAHGLZCd032764 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 17 Nov 2017 16:21:35 GMT Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserv0021.oracle.com (8.14.4/8.14.4) with ESMTP id vAHGLYf8000438 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 17 Nov 2017 16:21:34 GMT Original-Received: from abhmp0016.oracle.com (abhmp0016.oracle.com [141.146.116.22]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id vAHGLW11024474; Fri, 17 Nov 2017 16:21:33 GMT In-Reply-To: <86zi7l4ypn.fsf@zoho.com> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4615.0 (x86)] X-Source-IP: aserv0021.oracle.com [141.146.126.233] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] [fuzzy] X-Received-From: 141.146.126.69 X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "help-gnu-emacs" Xref: news.gmane.org gmane.emacs.help:114935 Archived-At: > >> By the way, what does `special' do? > >> > >> ;; FIXME document SPECIAL. (defun > >> transpose-subr (mover arg &optional special) > >> "Document SPECIAL" - good idea :) > > > > https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D29328 >=20 > Good. Now it says so in the source, I said > it here, and you said it on debbugs. > That should be enough. Alas, far from enough. The bug was was closed summarily, under the pretext that it's impossible to describe parameter SPECIAL, and that this is only an "internal subroutine" so it need not have complete doc. IOW, we don't know how to describe it, and we don't need to tell _you_ what it is anyway, lusers. Oh, and asking for this information is annoying "bike-shedding". Circulez ! Il n'y a rien a voir. So the full gamut of lame reasons: It's internal; it's unimportant; and we couldn't possibly describe it even if we wanted to. Anyone trying to define their own transposition function will likely need to use `transpose-subr' (that's what its for). So I can't imagine why it should be considered "internal". To me, this is like saying that `sort-subr' is internal. A whole section of the Elisp manual is devoted to that workhorse "subroutine". http://www.gnu.org/software/emacs/manual/html_node/elisp/Sorting.html