bug-gnu-emacs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

bug#3314: 23.0.93; Emacs manual, node RegPos


From: Juri Linkov
Subject: bug#3314: 23.0.93; Emacs manual, node RegPos
Date: Sun, 17 May 2009 21:45:45 +0300
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.93 (x86_64-pc-linux-gnu)

>> 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/






reply via email to

[Prev in Thread] Current Thread [Next in Thread]