From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs,gmane.emacs.pretest.bugs Subject: bug#3249: 23.0.93; doc of transpose-subr and transpose-regions Date: Sat, 9 May 2009 08:56:59 -0700 Message-ID: <009f01c9d0be$ca2f9750$0200a8c0@us.oracle.com> Reply-To: Drew Adams , 3249@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1241885539 13167 80.91.229.12 (9 May 2009 16:12:19 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 9 May 2009 16:12:19 +0000 (UTC) To: Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat May 09 18:12:09 2009 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1M2p9k-00018T-Lm for geb-bug-gnu-emacs@m.gmane.org; Sat, 09 May 2009 18:12:08 +0200 Original-Received: from localhost ([127.0.0.1]:41551 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1M2p9j-00063A-QE for geb-bug-gnu-emacs@m.gmane.org; Sat, 09 May 2009 12:12:07 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1M2p9e-000611-RN for bug-gnu-emacs@gnu.org; Sat, 09 May 2009 12:12:02 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1M2p9a-0005uf-0G for bug-gnu-emacs@gnu.org; Sat, 09 May 2009 12:12:02 -0400 Original-Received: from [199.232.76.173] (port=43740 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1M2p9Z-0005uY-C1 for bug-gnu-emacs@gnu.org; Sat, 09 May 2009 12:11:57 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:37956) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1M2p9Y-0005dQ-Si for bug-gnu-emacs@gnu.org; Sat, 09 May 2009 12:11:57 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n49GBsZA005252; Sat, 9 May 2009 09:11:55 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id n49G05lt000461; Sat, 9 May 2009 09:00:05 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: "Drew Adams" Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Sat, 09 May 2009 16:00:05 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: report 3249 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.124188461932696 (code B ref -1); Sat, 09 May 2009 16:00:05 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 9 May 2009 15:56:59 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n49FutaG032675 for ; Sat, 9 May 2009 08:56:56 -0700 Original-Received: from mail.gnu.org ([199.232.76.166]:58843 helo=mx10.gnu.org) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1M2ov0-0005YV-Tn for emacs-pretest-bug@gnu.org; Sat, 09 May 2009 11:56:55 -0400 Original-Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1M2ouz-0003vg-FW for emacs-pretest-bug@gnu.org; Sat, 09 May 2009 11:56:54 -0400 Original-Received: from rcsinet11.oracle.com ([148.87.113.123]:45795 helo=rgminet11.oracle.com) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1M2ouz-0003vK-4E for emacs-pretest-bug@gnu.org; Sat, 09 May 2009 11:56:53 -0400 Original-Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by rgminet11.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n49Fv9W3013857 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sat, 9 May 2009 15:57:10 GMT Original-Received: from abhmt004.oracle.com (abhmt004.oracle.com [141.146.116.13]) by acsinet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n49FvCAj005050 for ; Sat, 9 May 2009 15:57:12 GMT Original-Received: from dradamslap1 (/141.144.72.19) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 09 May 2009 08:56:47 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcnQvslKHnvRDsGlS6+e6gFvg4UiWg== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3350 X-Source-IP: abhmt004.oracle.com [141.146.116.13] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090205.4A05A7C0.021A:SCFSTAT5015188,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) Resent-Date: Sat, 09 May 2009 12:12:02 -0400 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:27796 gmane.emacs.pretest.bugs:24402 Archived-At: It seems that all transpose functions in Emacs are defined using `transpose-subr'. If you want to define your own transpose function, then you will presumably use `transpose-subr' too. But `transpose-subr' is not even documented, making it that much harder to try to use it to define your own transpose function. Please add a helpful doc string. It's apparently not as simple as providing a `forward-*' function and a numeric arg N to `transpose-subr'. That's what `transpose-chars', `transpose-words', `transpose-paragraphs', and `transpose-sentences do (using `forward-char' etc.), but that apparently is not adequate for `transpose-lines' or `transpose-sexps'. So it would, in particular, be helpful to know just what is needed as the MOVER arg of `transpose-subr'. Also, the Elisp manual, node Transposition, mentions only `transpose-regions', saying that it is used by the transposition commands. But it is not - the transposition commands all use `transpose-subr', and that doesn't even call `transpose-regions' indirectly. `transpose-regions' is used in the Elisp source code in only 4 places, in deuglify.el, mule-diag.el, and hanoi.el - never to define a transpose command. And `transpose-subr' is used in just as many files, not counting simple.el. So what is the correct advice to give Elisp programmers who want to define transpose functions? Shouldn't `transpose-subr' be documented in the Elisp manual, in addition to getting a doc string? Also, why is `transpose-regions' still defined in C code? Is that necessary for performance? In GNU Emacs 23.0.93.1 (i386-mingw-nt5.1.2600) of 2009-05-02 on SOFT-MJASON Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (3.4)'