From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!not-for-mail
From: Drew Adams <drew.adams@oracle.com>
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 07:46:49 -0700 (PDT)
Message-ID: <b15373cd-5f12-4dde-b999-d0b54c82aa52@default>
References: <<265aed11-7056-45f2-afbf-1b5f8b3b0a05@default>>
	<<83egos2df6.fsf@gnu.org>>
NNTP-Posting-Host: plane.gmane.org
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: quoted-printable
X-Trace: ger.gmane.org 1426344443 17588 80.91.229.3 (14 Mar 2015 14:47:23 GMT)
X-Complaints-To: usenet@ger.gmane.org
NNTP-Posting-Date: Sat, 14 Mar 2015 14:47:23 +0000 (UTC)
Cc: 20105@debbugs.gnu.org
To: Eli Zaretskii <eliz@gnu.org>
Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Mar 14 15:47:10 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 1YWnLK-0003FB-CT
	for geb-bug-gnu-emacs@m.gmane.org; Sat, 14 Mar 2015 15:47:10 +0100
Original-Received: from localhost ([::1]:40988 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 1YWnLJ-000394-HB
	for geb-bug-gnu-emacs@m.gmane.org; Sat, 14 Mar 2015 10:47:09 -0400
Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:53996)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1YWnLE-00036G-3s
	for bug-gnu-emacs@gnu.org; Sat, 14 Mar 2015 10:47:05 -0400
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1YWnLC-0006PQ-Qw
	for bug-gnu-emacs@gnu.org; Sat, 14 Mar 2015 10:47:04 -0400
Original-Received: from debbugs.gnu.org ([140.186.70.43]:48143)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1YWnLC-0006PK-Mo
	for bug-gnu-emacs@gnu.org; Sat, 14 Mar 2015 10:47:02 -0400
Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1YWnLC-0001Je-5d
	for bug-gnu-emacs@gnu.org; Sat, 14 Mar 2015 10:47:02 -0400
X-Loop: help-debbugs@gnu.org
Resent-From: Drew Adams <drew.adams@oracle.com>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@gnu.org
Resent-Date: Sat, 14 Mar 2015 14:47:02 +0000
Resent-Message-ID: <handler.20105.B20105.14263444155046@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.14263444155046
	(code B ref 20105); Sat, 14 Mar 2015 14:47:02 +0000
Original-Received: (at 20105) by debbugs.gnu.org; 14 Mar 2015 14:46:55 +0000
Original-Received: from localhost ([127.0.0.1]:46711 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.80)
	(envelope-from <debbugs-submit-bounces@debbugs.gnu.org>)
	id 1YWnL4-0001JJ-Ct
	for submit@debbugs.gnu.org; Sat, 14 Mar 2015 10:46:54 -0400
Original-Received: from aserp1040.oracle.com ([141.146.126.69]:45991)
	by debbugs.gnu.org with esmtp (Exim 4.80)
	(envelope-from <drew.adams@oracle.com>) id 1YWnL2-0001JB-9i
	for 20105@debbugs.gnu.org; Sat, 14 Mar 2015 10:46:53 -0400
Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71])
	by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with
	ESMTP id t2EEko34011751
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK);
	Sat, 14 Mar 2015 14:46:50 GMT
Original-Received: from aserz7022.oracle.com (aserz7022.oracle.com [141.146.126.231])
	by userv0021.oracle.com (8.13.8/8.13.8) with ESMTP id t2EEknfu008791
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL);
	Sat, 14 Mar 2015 14:46:49 GMT
Original-Received: from abhmp0007.oracle.com (abhmp0007.oracle.com [141.146.116.13])
	by aserz7022.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id
	t2EEkn86026011; Sat, 14 Mar 2015 14:46:49 GMT
In-Reply-To: <<83egos2df6.fsf@gnu.org>>
X-Priority: 3
X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2  (807160) [OL
	12.0.6691.5000 (x86)]
X-Source-IP: userv0021.oracle.com [156.151.31.71]
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:100474
Archived-At: <http://permalink.gmane.org/gmane.emacs.bugs/100474>

> > For `i home TAB' you see these candidates:
> > HOME
> > home directory shorthand
> >
> > In my setup I see also these two, but for some reason I don't see them
> > with `emacs -Q':
> > HOME directory on MS-Windows
> > HOME directory under MS-DOS
>=20
> I see all 4 of them in "emacs -Q".  Not sure why you don't; perhaps
> because your build is very old (but I doubt that).

No, I see only 2, even in this recent build (see end of this message).

> Do you have INFOPATH set in the environment, perhaps?

Nope.

> > In any case, those with the uppercase HOME should presumably not point
> > to node `Moving Point' (and, in particular, to the key `<home>'.  That
> > is wrong.  Presumably, `HOME' should take you to some information about
> > environment variable `HOME' or at least about the home directory.
>=20
> I disagree.  In general, index searches are deliberately
> case-insensitive.  In this particular case, you might assume that
> everyone knows the key is called <home>, but a seasonal reader of the
> manual does not necessarily know that; he could, for example, take
> inspiration from SPC, RET, TAB, etc.  We shouldn't fail those users,
> IMO.

I agree about (a) case-insensitive "in general" and (b) users might not
know about `<home>' vs `home' vs `HOME'.

But why is `HOME' capitalized as a candidate if it points to info about
the key?  That can only be misleading, I think.  I don't think Emacs
ever refers to the key that way (unlike, say, `TAB').

If we have a single `home' or `HOME' entry then we invite such problems.
(If we _must_ have a single such entry, I would expect it to point to
the env var.)

We should have similar treatment for the key and the env var, IMO.
E.g., if we have `home directory shorthand' then the key entry should
be something like `home keyboard key'.

And we don't seem to have any entry currently for the env var (?).
Shouldn't a user be able to find some info about it?
`HOME environment variable', for example.

Anyway, I don't have a brilliant solution.  But I noticed a problem.
Maybe you can make some improvement based on this feedback.  If not,
feel free to close the bug.

More recent build where I still see only two entries for `home TAB':

In GNU Emacs 25.0.50.1 (i686-pc-mingw32)
 of 2015-02-27 on LEG570
Repository revision: b2a590d4e3dc692a97c1b53e015b945d84b4b4c7
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --host=3Di686-pc-mingw32 --enable-checking=3Dyes,glyphs'

Configured features:
XPM JPEG TIFF GIF PNG RSVG SOUND NOTIFY ACL GNUTLS LIBXML2 ZLIB

Important settings:
  value of $LANG: ENU
  locale-coding-system: cp1252

Major mode: Info

Minor modes in effect:
  tooltip-mode: t
  global-eldoc-mode: t
  electric-indent-mode: t
  mouse-wheel-mode: t
  tool-bar-mode: t
  menu-bar-mode: t
  file-name-shadow-mode: t
  global-font-lock-mode: t
  font-lock-mode: t
  blink-cursor-mode: t
  auto-composition-mode: t
  auto-encryption-mode: t
  auto-compression-mode: t
  buffer-read-only: t
  line-number-mode: t

Recent messages:
For information about GNU Emacs and the GNU system, type C-h C-a.
Making completion list...
Quit [2 times]

Load-path shadows:
None found.

Features:
(shadow sort gnus-util mail-extr emacsbug message format-spec rfc822 mml
mml-sec mm-decode mm-bodies mm-encode mail-parse rfc2231 mailabbrev
gmm-utils mailheader sendmail rfc2047 rfc2045 ietf-drums mm-util
help-fns mail-prsvr mail-utils info easymenu dired time-date tooltip
eldoc electric uniquify ediff-hook vc-hooks lisp-float-type mwheel
dos-w32 ls-lisp disp-table w32-win w32-vars tool-bar dnd fontset image
regexp-opt fringe tabulated-list newcomment elisp-mode lisp-mode
prog-mode register page menu-bar rfn-eshadow timer select scroll-bar
mouse jit-lock font-lock syntax facemenu font-core frame cham georgian
utf-8-lang misc-lang vietnamese tibetan thai tai-viet lao korean
japanese hebrew greek romanian slovak czech european ethiopic indian
cyrillic chinese case-table epa-hook jka-cmpr-hook help simple abbrev
minibuffer cl-preloaded nadvice loaddefs button faces cus-face macroexp
files text-properties overlay sha1 md5 base64 format env code-pages mule
custom widget hashtable-print-readable backquote make-network-process
w32notify w32 multi-tty emacs)

Memory information:
((conses 8 187997 47058)
 (symbols 32 18506 1)
 (miscs 32 52 159)
 (strings 16 17991 4941)
 (string-bytes 1 413382)
 (vectors 8 9953)
 (vector-slots 4 396848 6048)
 (floats 8 68 277)
 (intervals 28 35386 3975)
 (buffers 516 15))