From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams 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: 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 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: 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 ) 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 ) 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 ) 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 ) 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 ) 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 ) 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 Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 14 Mar 2015 14:47:02 +0000 Resent-Message-ID: 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 ) 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 ) 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" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-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: > > 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 `'. 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 , 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 `' 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))