bug#3314: 23.0.93; Emacs manual, node RegPos

Juri Linkov <[email protected]>
Newsgroups gmane.emacs.bugs,gmane.emacs.pretest.bugs
Organization JURTA
Message-ID <[email protected]>
>> 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/
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.