From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Boruch Baum Newsgroups: gmane.emacs.bugs Subject: bug#30085: 25.2: Documentation for cua-rectangle-mark-mode Date: Fri, 12 Jan 2018 02:14:26 -0500 Message-ID: <20180112071426.uq2x3nlcs6jo57hm@E15-2016.optimum.net> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: blaine.gmane.org 1515741195 23112 195.159.176.226 (12 Jan 2018 07:13:15 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 12 Jan 2018 07:13:15 +0000 (UTC) User-Agent: NeoMutt/20171215 To: 30085@debbugs.gnu.org, storm@cua.dk Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Jan 12 08:13:11 2018 Return-path: Envelope-to: geb-bug-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 1eZtWY-0005WD-HH for geb-bug-gnu-emacs@m.gmane.org; Fri, 12 Jan 2018 08:13:10 +0100 Original-Received: from localhost ([::1]:49583 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eZtYW-0002NC-Dc for geb-bug-gnu-emacs@m.gmane.org; Fri, 12 Jan 2018 02:15:12 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60411) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eZtYP-0002Mm-JN for bug-gnu-emacs@gnu.org; Fri, 12 Jan 2018 02:15:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eZtYM-00012c-Do for bug-gnu-emacs@gnu.org; Fri, 12 Jan 2018 02:15:05 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:44913) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1eZtYM-000128-9N for bug-gnu-emacs@gnu.org; Fri, 12 Jan 2018 02:15:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1eZtYM-0002zt-0t for bug-gnu-emacs@gnu.org; Fri, 12 Jan 2018 02:15:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Boruch Baum Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 12 Jan 2018 07:15:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 30085 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Emacs Bug Reporting , "Kim F. Storm" Original-Received: via spool by submit@debbugs.gnu.org id=B.151574129011481 (code B ref -1); Fri, 12 Jan 2018 07:15:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 12 Jan 2018 07:14:50 +0000 Original-Received: from localhost ([127.0.0.1]:52810 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eZtY6-0002z3-Ex for submit@debbugs.gnu.org; Fri, 12 Jan 2018 02:14:50 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:41146) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eZtY4-0002yn-JC for submit@debbugs.gnu.org; Fri, 12 Jan 2018 02:14:45 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eZtXy-0000d5-5E for submit@debbugs.gnu.org; Fri, 12 Jan 2018 02:14:39 -0500 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:54223) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1eZtXy-0000d1-0w for submit@debbugs.gnu.org; Fri, 12 Jan 2018 02:14:38 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60343) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eZtXw-0002I4-RK for bug-gnu-emacs@gnu.org; Fri, 12 Jan 2018 02:14:37 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eZtXt-0000aH-MV for bug-gnu-emacs@gnu.org; Fri, 12 Jan 2018 02:14:36 -0500 Original-Received: from mout.gmx.net ([212.227.15.19]:56301) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1eZtXt-0000YJ-BS for bug-gnu-emacs@gnu.org; Fri, 12 Jan 2018 02:14:33 -0500 Original-Received: from E15-2016.optimum.net ([108.6.168.221]) by mail.gmx.com (mrgmx001 [212.227.17.184]) with ESMTPSA (Nemesis) id 0M39zL-1etUlG1nKp-00srav; Fri, 12 Jan 2018 08:14:29 +0100 Content-Disposition: inline X-Provags-ID: V03:K0:XfRf9e4doJi+9lqhnnS3KI8rLn1XNKPNtvf4oS1u3mYDhnXi5yC MMBCmZ57dTkzJadoKxJbW1xGXvg8vtf63jtPNkCbnvn/EBUQZRty+weV2fNMJNq73jfngCE 2MXAau9JJKA1P11wSp3Tmj2TV4vyONm8CLChJSchU5EHdNSVnrB31thLmt8/xIJwCWTyAnd g53WyoBR72TAk0maqq8rQ== X-UI-Out-Filterresults: notjunk:1;V01:K0:qdTFMSw0jrY=:+dxzuXTHSAVco4yqZ3qaiX IvdXY1LSS2C/sTxbWe68+UTMEMY2bW3KnLjG8E0C9+ssL+VwRaBr+pCjuGIi1dO/PUTuiGbCU ph4H0fRwlB4jvsMeA2n0qVOc1npQQAsfnY7Rt6upsZf+wBYoHeH86ev7/UW607NBUn7ysZYIz DivqNMCK6SuFQU8DOqV3jzacjuuzPMeb9Gvt8HrPEyb/xJ6rkSaGN/cjraauwf4k9Thc8ECkk KxcuyAqR1wAyuGxyXHnsX7c+cDlXLbBkTAG5yEmDZh8jgWaYPc3lZk8FS1W8Vy6rhMxE93PUQ AhcGEtRyjo777rnxmiefrOmWQcLFpYBciLLzahXR9U1zAWVJC/ngGzbpBdrYO4n2qIG5a+C9R Zvrth7aPf0D4yP5227LnyEcuiEhhM/7LJNrFYi2dJPVPlwjqvNHcpR30MHapi8L0uab4kZThs hIlK1kXTS3OXz11gfWZrQa/8g4WpZiwovI4CPYQ4cGezFyXKdK6VywiTEBRgw10j4MO5Taj5I m21Wb1aLWs5W9TjuR4p26xCM5Ck5ESkhsJMWTYo4ftPDXorcdpELZehTOTe5vlHdftfYfVRy2 ZqTJUu99IjTSSaQ6gwn9FhjMPiPNLBCa2LKsumZyF+xPg7Cb9lMZLcXgCEJ3tivLH2w3kUkl/ rYkAcU4Patr2K70KKuTW+uO7o6JqiQ+WZyV/1mCfj1qzEI2wEoHVJIgZCJ02xwQY+xq0X7Xsx Eb95EJMlDkrhTxCIdzIkbti2zA0ovJVKUH8jVDySBUWkF2GVIVeEnxet9AAIHlCJIY0RzdZ8 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:142069 Archived-At: `cua-rectangle-mark-mode' includes many features that I haven't found documented. This minor mode clearly allows for several advanced features, as it displays a helpful message on the mode line: C-?:help M-p:pad M-o:open M-c:close M-b:blank M-s:string M-f:fill M-i:incr M-n:seq This is a particular shame since `cua-rectangle-mark-mode' seems much more powerful and user-friendly than the collection of commands that are documented in the `rectangles' section of the emacs manual. However: 1. The documentation for the minor mode only says: "Toggle the region as rectangular. Activates the region if needed. Only lasts until the region is deactivated." 2. File `cua-rect.el' does not include a commentary of its features. 3. The emacs manual does have a section on `rectangles' that makes no mention of this minor mode. 4. An internet search for the feature or even its explicit name does not, at least prominently, yield any documentation. 5. The minor mode binds `C-?' to some help documentation. However, for users of emacs-nox such as myself, the keybinding `C-?' doesn't work. In this particular case, I did attempt the "usual" `C-@ c ?', but that also did not work. The standard `C-h' keybinding is available but unfortunately not used. 5.1. Keybinding `C-?' invokes function `cua-help-for-rectangle' which does not look at all helpful over the one-line mode-line string. 6. The tail of file `cua-rect.el' includes keybindings for many features not listed in the mode-line doc-string, eg. `reverse-rectangle', `shell-command-on-rectangle'. See there for more. File `cua-rect.el' list its author as Kim F. Storm , so I've taken the liberty of cc'ing the author on the bug report. @Kim: Your work seems like a great improvement over emacs' documented rectangle support, but seems to have remained relatively unknown due to lack of documentation. It should be front and center in any search for emacs rectangle support. -- hkp://keys.gnupg.net CA45 09B5 5351 7C11 A9D1 7286 0036 9E45 1595 8BC0