From: Gareth Rees <gareth.rees@pobox.com>
To: bug-gnu-emacs@gnu.org
Subject: bug#4345: Manual suggestions for point and cursor
Date: Sat, 5 Sep 2009 00:28:46 +0100 [thread overview]
Message-ID: <4676E53B-1679-4FDA-ABB4-07560C8C95D8@pobox.com> (raw)
In GNU Emacs 23.1.1 (powerpc-apple-darwin9.8.0, NS apple-
appkit-949.54) of 2009-08-18 on Chihiro.local
Windowing system distributor `Apple', version 10.3.949
configured using `configure '--with-ns''
Some Emacs manual suggestions to do with describing the nature of the
cursor and point.
1. In the Emacs manual, node "Point", it says "While the cursor
appears to be _on_ a character, you should think of point as _between_
two characters; it points _before_ the character that appears under
the cursor." The cursor only appears to be on a character if you have
a block cursor configured. With a vertical bar cursor, the cursor
appears to be between characters, and with a horizontal bar cursor,
the cursor appears to be underneath a character. The manual might
qualify the claim being made here.
2. Later in the "Point" node, it says, "On a graphical display, Emacs
shows a cursor in each window; the selected window's cursor is solid
and blinking, and the other cursors are hollow." The manual might note
that this is the default for how the cursor is displayed and that the
shape can be configured.
3. In the node "Cursor Display", it is mentioned that you can
configure the shape of the cursor: "For a box cursor, this is a hollow
box; for a bar cursor, this is a thinner bar." However, no explanation
is given for how to do this. The manual might mention the cursor-type
frame parameter, and link to the elisp manual node "Cursor Parameters".
4. In the node "Table Recognition", the phrase "under point" appears
four times. Generally the Emacs manual is careful to use the phrase
"after point" when mentioning a character position, or "at point" when
mentioning a vaguer location. I suggest that "under point" be changed
to "at point" in this node.
--
Gareth Rees
next reply other threads:[~2009-09-04 23:28 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2009-09-04 23:28 Gareth Rees [this message]
2011-07-12 22:39 ` bug#4345: Manual suggestions for point and cursor Lars Magne Ingebrigtsen
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
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=4676E53B-1679-4FDA-ABB4-07560C8C95D8@pobox.com \
--to=gareth.rees@pobox.com \
--cc=4345@emacsbugs.donarmstrong.com \
--cc=bug-gnu-emacs@gnu.org \
/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 external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.