From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Gareth Rees Newsgroups: gmane.emacs.bugs Subject: bug#4345: Manual suggestions for point and cursor Date: Sat, 5 Sep 2009 00:28:46 +0100 Message-ID: <4676E53B-1679-4FDA-ABB4-07560C8C95D8@pobox.com> Reply-To: Gareth Rees , 4345@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 (Apple Message framework v936) Content-Type: text/plain; charset=US-ASCII; format=flowed; delsp=yes Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1252108039 19950 80.91.229.12 (4 Sep 2009 23:47:19 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 4 Sep 2009 23:47:19 +0000 (UTC) To: bug-gnu-emacs@gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Sep 05 01:47:12 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 1MjiUp-0002t5-MH for geb-bug-gnu-emacs@m.gmane.org; Sat, 05 Sep 2009 01:47:12 +0200 Original-Received: from localhost ([127.0.0.1]:49325 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MjiUp-0007ah-3R for geb-bug-gnu-emacs@m.gmane.org; Fri, 04 Sep 2009 19:47:11 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MjiUj-0007Xp-Rt for bug-gnu-emacs@gnu.org; Fri, 04 Sep 2009 19:47:05 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MjiUf-0007U4-6o for bug-gnu-emacs@gnu.org; Fri, 04 Sep 2009 19:47:05 -0400 Original-Received: from [199.232.76.173] (port=46971 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MjiUf-0007Tu-3U for bug-gnu-emacs@gnu.org; Fri, 04 Sep 2009 19:47:01 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:49899) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MjiUe-0007en-GK for bug-gnu-emacs@gnu.org; Fri, 04 Sep 2009 19:47:00 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n84NkwjO004249; Fri, 4 Sep 2009 16:46:58 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n84NZ6Pv002016; Fri, 4 Sep 2009 16:35:06 -0700 Resent-Date: Fri, 4 Sep 2009 16:35:06 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: Gareth Rees Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs 2Resent-Date: Fri, 04 Sep 2009 23:35:05 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: report 4345 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.1252106947837 (code B ref -1); Fri, 04 Sep 2009 23:35:05 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 4 Sep 2009 23:29:07 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n84NT5QI000834 for ; Fri, 4 Sep 2009 16:29:07 -0700 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MjiDJ-0001Q0-18 for bug-gnu-emacs@gnu.org; Fri, 04 Sep 2009 19:29:05 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MjiDE-0001Hz-DU for bug-gnu-emacs@gnu.org; Fri, 04 Sep 2009 19:29:04 -0400 Original-Received: from [199.232.76.173] (port=41772 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MjiDE-0001Hh-7i for bug-gnu-emacs@gnu.org; Fri, 04 Sep 2009 19:29:00 -0400 Original-Received: from a-pb-sasl-sd.pobox.com ([64.74.157.62]:55506 helo=sasl.smtp.pobox.com) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1MjiDD-0004gQ-N7 for bug-gnu-emacs@gnu.org; Fri, 04 Sep 2009 19:28:59 -0400 Original-Received: from sasl.smtp.pobox.com (unknown [127.0.0.1]) by a-pb-sasl-sd.pobox.com (Postfix) with ESMTP id E3FE7443D1 for ; Fri, 4 Sep 2009 19:28:56 -0400 (EDT) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=pobox.com; h=message-id :from:to:content-type:content-transfer-encoding:mime-version :subject:date; s=sasl; bh=R38fXtUXK+75FsKl41lLjwuV9lk=; b=UqQ7Jx gJeVPfkPmG/oxBRbCxTlqc12oPbkazLZoubEB42/9FYfFpNf+C1ySaRv1RIxwKg+ R1x8qD0lwesPj+d3e5CwLiQyTULUg9x5Ex/X5DMS073pVz5xv8VdNk5TGiC/MYN1 g2dzZOntjeIW+j49gZo4imra6h0F7J1BP8q2c= DomainKey-Signature: a=rsa-sha1; c=nofws; d=pobox.com; h=message-id:from :to:content-type:content-transfer-encoding:mime-version:subject :date; q=dns; s=sasl; b=LNna4Kh0mctMcloXXT7mjRzRrRVn1aCW7GKJ7nE8 gKtY3nhVIJ3hQtckLNjRWr8tTIniEueG8c/N7SauTXJodg5jkOvvwuTFfuI+L15q pq8UOyNB6mnZJfjoC9Ap7B7ptfrNd6w1HK19usvjIDwci9u9maSJVsQb6nwLv6mY 1eM= Original-Received: from a-pb-sasl-sd.pobox.com (unknown [127.0.0.1]) by a-pb-sasl-sd.pobox.com (Postfix) with ESMTP id E03A3443D0 for ; Fri, 4 Sep 2009 19:28:56 -0400 (EDT) Original-Received: from [192.168.0.2] (unknown [82.69.91.179]) by a-pb-sasl-sd.pobox.com (Postfix) with ESMTPA id 43147443CE for ; Fri, 4 Sep 2009 19:28:55 -0400 (EDT) X-Mailer: Apple Mail (2.936) X-Pobox-Relay-ID: B76FAFC8-99AA-11DE-8C86-8B19076EA04E-43646240!a-pb-sasl-sd.pobox.com X-detected-operating-system: by monty-python.gnu.org: Solaris 10 (beta) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) Resent-Date: Fri, 04 Sep 2009 19:47:05 -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:30809 Archived-At: 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