From: Juri Linkov <juri@jurta.org>
To: Drew Adams <drew.adams@oracle.com>
Cc: 3314@emacsbugs.donarmstrong.com, rms@gnu.org, emacs-pretest-bug@gnu.org
Subject: bug#3314: 23.0.93; Emacs manual, node RegPos
Date: Sun, 17 May 2009 21:45:45 +0300 [thread overview]
Message-ID: <87eiunsh7c.fsf@mail.jurta.org> (raw)
In-Reply-To: <002b01c9d716$551483f0$0200a8c0@us.oracle.com> (Drew Adams's message of "Sun, 17 May 2009 10:38:46 -0700")
>> 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/
next prev parent reply other threads:[~2009-05-17 18:45 UTC|newest]
Thread overview: 19+ messages / expand[flat|nested] mbox.gz Atom feed top
2009-05-16 22:29 bug#3314: 23.0.93; Emacs manual, node RegPos Drew Adams
2009-05-17 17:23 ` Richard M Stallman
2009-05-17 17:38 ` Drew Adams
2009-05-17 18:45 ` Juri Linkov [this message]
2009-05-17 19:00 ` Drew Adams
2009-05-17 19:05 ` Drew Adams
2009-05-17 19:17 ` Juri Linkov
2009-05-17 19:47 ` Drew Adams
2009-05-17 21:27 ` Juri Linkov
2009-05-17 21:38 ` Drew Adams
2009-05-18 16:45 ` Richard M Stallman
2009-05-18 3:24 ` Stefan Monnier
2011-07-11 15:42 ` Lars Magne Ingebrigtsen
2011-07-12 19:06 ` Richard Stallman
2011-07-12 19:34 ` Lars Magne Ingebrigtsen
2011-07-13 18:32 ` Richard Stallman
2011-07-12 19:42 ` Lars Magne Ingebrigtsen
2009-05-18 16:44 ` Richard M Stallman
2009-05-22 4:36 ` Kevin Rodgers
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=87eiunsh7c.fsf@mail.jurta.org \
--to=juri@jurta.org \
--cc=3314@emacsbugs.donarmstrong.com \
--cc=drew.adams@oracle.com \
--cc=emacs-pretest-bug@gnu.org \
--cc=rms@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.