From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.bugs,gmane.emacs.pretest.bugs Subject: bug#3314: 23.0.93; Emacs manual, node RegPos Date: Sun, 17 May 2009 21:45:45 +0300 Organization: JURTA Message-ID: <87eiunsh7c.fsf@mail.jurta.org> References: <000201c9d675$cf77ea70$0200a8c0@us.oracle.com> <002b01c9d716$551483f0$0200a8c0@us.oracle.com> Reply-To: Juri Linkov , 3314@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1242587600 24842 80.91.229.12 (17 May 2009 19:13:20 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 17 May 2009 19:13:20 +0000 (UTC) Cc: 3314@emacsbugs.donarmstrong.com, rms@gnu.org, emacs-pretest-bug@gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun May 17 21:13:13 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 1M5lnM-0000bN-OJ for geb-bug-gnu-emacs@m.gmane.org; Sun, 17 May 2009 21:13:13 +0200 Original-Received: from localhost ([127.0.0.1]:44847 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1M5lnM-0005dC-5N for geb-bug-gnu-emacs@m.gmane.org; Sun, 17 May 2009 15:13:12 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1M5lmI-0004xI-T1 for bug-gnu-emacs@gnu.org; Sun, 17 May 2009 15:12:07 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1M5lmE-0004ug-3E for bug-gnu-emacs@gnu.org; Sun, 17 May 2009 15:12:06 -0400 Original-Received: from [199.232.76.173] (port=55005 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1M5lmD-0004uJ-LV for bug-gnu-emacs@gnu.org; Sun, 17 May 2009 15:12:01 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:49989) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1M5lmC-00071x-JE for bug-gnu-emacs@gnu.org; Sun, 17 May 2009 15:12:01 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n4HJBuEo006077; Sun, 17 May 2009 12:11:57 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id n4HIt5Mf032317; Sun, 17 May 2009 11:55:05 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: Juri Linkov Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Sun, 17 May 2009 18:55:05 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: followup 3314 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.124258625131337 (code B ref -1); Sun, 17 May 2009 18:55:05 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 17 May 2009 18:50:51 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n4HIomcI031327 for ; Sun, 17 May 2009 11:50:49 -0700 Original-Received: from mx10.gnu.org ([199.232.76.166]:47233) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1M5lRc-0008Lu-66 for emacs-pretest-bug@gnu.org; Sun, 17 May 2009 14:50:44 -0400 Original-Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1M5lRZ-0000Ya-Al for emacs-pretest-bug@gnu.org; Sun, 17 May 2009 14:50:43 -0400 Original-Received: from relay03.kiev.sovam.com ([62.64.120.201]:52012) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1M5lRY-0000W3-GS; Sun, 17 May 2009 14:50:40 -0400 Original-Received: from [83.170.232.243] (helo=smtp.svitonline.com) by relay03.kiev.sovam.com with esmtp (Exim 4.69) (envelope-from ) id 1M5lRO-000N84-1a; Sun, 17 May 2009 21:50:30 +0300 In-Reply-To: <002b01c9d716$551483f0$0200a8c0@us.oracle.com> (Drew Adams's message of "Sun, 17 May 2009 10:38:46 -0700") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.93 (x86_64-pc-linux-gnu) X-Scanner-Signature: 8fcfa5a562f326ba64a474cd1db6e25e X-DrWeb-checked: yes X-detected-operating-system: by monty-python.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) Resent-Date: Sun, 17 May 2009 15:12:06 -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:27925 gmane.emacs.pretest.bugs:24440 Archived-At: >> The reason for abbreviating some node names is to prevent the node's >> first line (in the Info file) from wrapping in an ugly way. > > Not a good solution, IMO. > > Even if no good solution for the wrapping problem could be found, it is more > important that nodes have helpful names than that wrapping be avoided. > > And a name can be helpful without being overly long. > > And this and the other node names in this section would not be longer than most > if named normally: `Positional Register' as a substitute for `RegPos' is not > longer than most other nodes. In your original bug report you wrote: Good node names let you find appropriate nodes using completion etc. However, the name `Positional Register' makes it harder to find all register related nodes using completion because it doesn't begin with a common word. Currently these node names begin with a common prefix `Reg'. So it would be better if they all had a common prefix that is a complete and clear word `Register': RegPos -> Register Positions RegText -> Register Text RegRect -> Register Rectangles RegConfig -> Register Configurations RegNumbers -> Register Numbers RegFiles -> Register Files I see no problems with this change because an Info "breadcrumb" line is still short, e.g. (emacs)Top > Registers > Register Rectangles and the header line will fit into 80 columns as well. -- Juri Linkov http://www.jurta.org/emacs/