From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!not-for-mail
From: Eli Zaretskii <eliz@gnu.org>
Newsgroups: gmane.emacs.bugs
Subject: bug#20105: 25.0.50;
	Emacs manual, `i HOME RET' sends you to `Moving Point', which is wrong
Date: Sat, 14 Mar 2015 18:15:10 +0200
Message-ID: <83zj7f1rox.fsf@gnu.org>
References: <265aed11-7056-45f2-afbf-1b5f8b3b0a05@default>
	<83egos2df6.fsf@gnu.org> <b15373cd-5f12-4dde-b999-d0b54c82aa52@default>
	<834mpn38iu.fsf@gnu.org> <9fe72841-fa75-4bbe-bb92-c14e68e0cd7a@default>
Reply-To: Eli Zaretskii <eliz@gnu.org>
NNTP-Posting-Host: plane.gmane.org
X-Trace: ger.gmane.org 1426349785 827 80.91.229.3 (14 Mar 2015 16:16:25 GMT)
X-Complaints-To: usenet@ger.gmane.org
NNTP-Posting-Date: Sat, 14 Mar 2015 16:16:25 +0000 (UTC)
Cc: 20105@debbugs.gnu.org
To: Drew Adams <drew.adams@oracle.com>
Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Mar 14 17:16:16 2015
Return-path: <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>
Envelope-to: geb-bug-gnu-emacs@m.gmane.org
Original-Received: from lists.gnu.org ([208.118.235.17])
	by plane.gmane.org with esmtp (Exim 4.69)
	(envelope-from <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>)
	id 1YWojU-0005iW-LO
	for geb-bug-gnu-emacs@m.gmane.org; Sat, 14 Mar 2015 17:16:12 +0100
Original-Received: from localhost ([::1]:41314 helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>)
	id 1YWojT-0007ds-Rv
	for geb-bug-gnu-emacs@m.gmane.org; Sat, 14 Mar 2015 12:16:11 -0400
Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38801)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1YWojN-0007dm-93
	for bug-gnu-emacs@gnu.org; Sat, 14 Mar 2015 12:16:08 -0400
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1YWojK-0005Hk-3L
	for bug-gnu-emacs@gnu.org; Sat, 14 Mar 2015 12:16:05 -0400
Original-Received: from debbugs.gnu.org ([140.186.70.43]:48180)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1YWojJ-0005Hg-Vk
	for bug-gnu-emacs@gnu.org; Sat, 14 Mar 2015 12:16:02 -0400
Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1YWojJ-0003be-KO
	for bug-gnu-emacs@gnu.org; Sat, 14 Mar 2015 12:16:01 -0400
X-Loop: help-debbugs@gnu.org
Resent-From: Eli Zaretskii <eliz@gnu.org>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@gnu.org
Resent-Date: Sat, 14 Mar 2015 16:16:01 +0000
Resent-Message-ID: <handler.20105.B20105.142634972413817@debbugs.gnu.org>
Resent-Sender: help-debbugs@gnu.org
X-GNU-PR-Message: followup 20105
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: 
Original-Received: via spool by 20105-submit@debbugs.gnu.org id=B20105.142634972413817
	(code B ref 20105); Sat, 14 Mar 2015 16:16:01 +0000
Original-Received: (at 20105) by debbugs.gnu.org; 14 Mar 2015 16:15:24 +0000
Original-Received: from localhost ([127.0.0.1]:46748 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.80)
	(envelope-from <debbugs-submit-bounces@debbugs.gnu.org>)
	id 1YWoih-0003an-EG
	for submit@debbugs.gnu.org; Sat, 14 Mar 2015 12:15:23 -0400
Original-Received: from mtaout28.012.net.il ([80.179.55.184]:55892)
	by debbugs.gnu.org with esmtp (Exim 4.80)
	(envelope-from <eliz@gnu.org>) id 1YWoif-0003ad-3L
	for 20105@debbugs.gnu.org; Sat, 14 Mar 2015 12:15:22 -0400
Original-Received: from conversion-daemon.mtaout28.012.net.il by mtaout28.012.net.il
	(HyperSendmail v2007.08) id <0NL700500LTEDX00@mtaout28.012.net.il> for
	20105@debbugs.gnu.org; Sat, 14 Mar 2015 18:13:51 +0200 (IST)
Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout28.012.net.il
	(HyperSendmail v2007.08) with ESMTPA id
	<0NL7005WPMF3Q810@mtaout28.012.net.il>;
	Sat, 14 Mar 2015 18:13:51 +0200 (IST)
In-reply-to: <9fe72841-fa75-4bbe-bb92-c14e68e0cd7a@default>
X-012-Sender: halo1@inter.net.il
X-BeenThere: debbugs-submit@debbugs.gnu.org
X-Mailman-Version: 2.1.15
Precedence: list
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x
X-Received-From: 140.186.70.43
X-BeenThere: bug-gnu-emacs@gnu.org
List-Id: "Bug reports for GNU Emacs,
	the Swiss army knife of text editors" <bug-gnu-emacs.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/bug-gnu-emacs>
List-Post: <mailto:bug-gnu-emacs@gnu.org>
List-Help: <mailto:bug-gnu-emacs-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=subscribe>
Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org
Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org
Xref: news.gmane.org gmane.emacs.bugs:100477
Archived-At: <http://permalink.gmane.org/gmane.emacs.bugs/100477>

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