From unknown Wed Jun 18 00:11:38 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#4345 <4345@debbugs.gnu.org> To: bug#4345 <4345@debbugs.gnu.org> Subject: Status: Manual suggestions for point and cursor Reply-To: bug#4345 <4345@debbugs.gnu.org> Date: Wed, 18 Jun 2025 07:11:38 +0000 retitle 4345 Manual suggestions for point and cursor reassign 4345 emacs submitter 4345 Gareth Rees severity 4345 minor tag 4345 fixed thanks From gareth.rees@pobox.com Fri Sep 4 16:29:07 2009 Received: (at submit) by emacsbugs.donarmstrong.com; 4 Sep 2009 23:29:07 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=0.0 required=4.0 tests=none autolearn=ham version=3.2.5-bugs.debian.org_2005_01_02 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 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 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 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 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 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= 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) 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) Message-Id: <4676E53B-1679-4FDA-ABB4-07560C8C95D8@pobox.com> From: Gareth Rees To: bug-gnu-emacs@gnu.org Content-Type: text/plain; charset=US-ASCII; format=flowed; delsp=yes Content-Transfer-Encoding: 7bit Mime-Version: 1.0 (Apple Message framework v936) Subject: Manual suggestions for point and cursor Date: Sat, 5 Sep 2009 00:28:46 +0100 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) 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 From debbugs-submit-bounces@debbugs.gnu.org Tue Jul 12 18:39:56 2011 Received: (at control) by debbugs.gnu.org; 12 Jul 2011 22:39:57 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QglcS-0007zU-3s for submit@debbugs.gnu.org; Tue, 12 Jul 2011 18:39:56 -0400 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QglcQ-0007zF-1y for control@debbugs.gnu.org; Tue, 12 Jul 2011 18:39:54 -0400 Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=quimbies.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1QglcE-0007EF-Ll for control@debbugs.gnu.org; Wed, 13 Jul 2011 00:39:42 +0200 Date: Wed, 13 Jul 2011 00:39:42 +0200 Message-Id: To: control@debbugs.gnu.org From: Lars Magne Ingebrigtsen Subject: control message for bug #4345 X-MailScanner-ID: 1QglcE-0007EF-Ll X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1311115182.78684@EyfYtX8URmKpF802k9eRUA X-Spam-Status: No X-Spam-Score: -2.7 (--) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.7 (--) tags 4345 fixed close 4345 24.1 From debbugs-submit-bounces@debbugs.gnu.org Tue Jul 12 18:40:14 2011 Received: (at 4345) by debbugs.gnu.org; 12 Jul 2011 22:40:14 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qglcg-00080U-BX for submit@debbugs.gnu.org; Tue, 12 Jul 2011 18:40:14 -0400 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qglca-0007zd-PI for 4345@debbugs.gnu.org; Tue, 12 Jul 2011 18:40:08 -0400 Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=quimbies.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1QglcK-0007ET-PV; Wed, 13 Jul 2011 00:39:48 +0200 From: Lars Magne Ingebrigtsen To: Gareth Rees Subject: Re: Manual suggestions for point and cursor In-Reply-To: <4676E53B-1679-4FDA-ABB4-07560C8C95D8@pobox.com> (Gareth Rees's message of "Sat, 5 Sep 2009 00:28:46 +0100") Date: Wed, 13 Jul 2011 00:39:40 +0200 Message-ID: References: <4676E53B-1679-4FDA-ABB4-07560C8C95D8@pobox.com> User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.50 (gnu/linux) X-Now-Playing: Peter Gabriel's _B-Sides and More (1)_: "Party Man" X-Hashcash: 1:23:110712:4345@debbugs.gnu.org::xXb4rTs2lxWS/1z1:000000000000000000000000000000000000000003e1C X-Hashcash: 1:23:110712:gareth.rees@pobox.com::OX+DtO4fJGIkO+QZ:00000000000000000000000000000000000000009e+C MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1QglcK-0007ET-PV X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1311115188.88336@saLw/0IOaSxCe7vcmRzHzw X-Spam-Status: No X-Spam-Score: -2.7 (--) X-Debbugs-Envelope-To: 4345 Cc: 4345@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.7 (--) Gareth Rees writes: > 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. Ok; fixed in Emacs 24. > 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. Ditto. > 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". I've now mentioned cursor-type here. > 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. Ditto. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/ From unknown Wed Jun 18 00:11:38 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Wed, 10 Aug 2011 11:24:05 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator