bug#20105: 25.0.50; Emacs manual, `i HOME RET' sends you to `Moving Point', which is wrong

[Eli Zaretskii <eliz@gnu.org>]

> Date: Sat, 14 Mar 2015 08:59:29 -0700 (PDT)
> From: Drew Adams <drew.adams@oracle.com>
> Cc: 20105@debbugs.gnu.org
> 
> > Strange.  I have no idea why you see only 2 candidates.  I see all 4
> > in both the master and emacs-24 branch.
> 
> I hear you.  I don't know why.  I'm on Windows 7 64-bit.  Other than
> that, I don't know what else I can add here.
> 
> But see below.  I do have those two missing candidates as explicit
> entries in the manual indexes.  It is completion that, for some reason,
> fails to pick them up.  I don't see how you get different behavior, if
> we're both using `emacs -Q'.

Yes, "emacs -Q" here.  And it's not a surprise you have those missing
candidates in the index, that's how I can see them ;-)

Are you sure you did 'i home TAB' in the latest manual, though?

> > > But why is `HOME' capitalized as a candidate if it points to info about
> > > the key?
> > 
> > Don't know.  Looks like some feature of completion.
> 
> Really?  My guess is instead that it comes from this explicit index
> entry (which I see in Emacs 24 but not 23): (I removed some whitespace.)
> 
> * HOME:             Moving Point.        (line  57)

By "feature" I meant that it replaces "home" which I typed by "HOME",
for whatever reasons.  The _only_ reason that I could accept as
legitimate is if _all_ completion candidates started with an
upper-case "HOME".  But that's not what we have here.  So it looks
like some attempt at being smart is misfiring.

> That's from the Key Index.  However, note that there are also these
> two entries in the Variable Index, which seem not to be used when
> I do `i home TAB':
> 
> * HOME:             General Variables.   (line  59)
> * HOSTNAME:         General Variables.   (line  70)

HOME _is_ used, except that completion removes duplicates (I guess).
As for HOSTNAME -- why should it be used?  I don't see it used here.

> >From what I see, the only explicit index entries that include `HOME'
> (capitalized) refer to the home directory, not to the <home> key.

No, the entry that revers to "Moving Point" is also capitalized.