From: Boruch Baum <boruch_baum@gmx.com>
To: 30085@debbugs.gnu.org, storm@cua.dk
Subject: bug#30085: 25.2: Documentation for cua-rectangle-mark-mode
Date: Fri, 12 Jan 2018 02:14:26 -0500 [thread overview]
Message-ID: <20180112071426.uq2x3nlcs6jo57hm@E15-2016.optimum.net> (raw)
`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 <storm@cua.dk>, 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
next reply other threads:[~2018-01-12 7:14 UTC|newest]
Thread overview: 17+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-01-12 7:14 Boruch Baum [this message]
2018-01-12 9:22 ` bug#30085: 25.2: Documentation for cua-rectangle-mark-mode Eli Zaretskii
2018-01-12 11:00 ` Kim Storm
2018-01-12 18:53 ` Eli Zaretskii
2018-01-26 18:57 ` Boruch Baum
2018-03-21 12:48 ` Boruch Baum
2020-10-27 1:50 ` Stefan Kangas
2020-10-28 6:40 ` Boruch Baum
2020-12-16 7:43 ` Boruch Baum
2018-01-12 11:06 ` Kim Storm
2019-10-19 1:21 ` Stefan Kangas
2019-10-19 6:39 ` Eli Zaretskii
2020-10-27 1:39 ` Stefan Kangas
2019-10-23 10:56 ` Boruch Baum
2019-10-23 11:10 ` Stefan Kangas
2019-10-28 10:41 ` Lars Ingebrigtsen
2019-10-28 16:11 ` Eli Zaretskii
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20180112071426.uq2x3nlcs6jo57hm@E15-2016.optimum.net \
--to=boruch_baum@gmx.com \
--cc=30085@debbugs.gnu.org \
--cc=storm@cua.dk \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).