unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
From: Eli Zaretskii <eliz@gnu.org>
To: Michael Albinus <michael.albinus@gmx.de>
Cc: 30463@debbugs.gnu.org
Subject: bug#30463: 26.0.91; info-lookup-symbol oddities
Date: Thu, 15 Feb 2018 19:03:11 +0200	[thread overview]
Message-ID: <837erew5gw.fsf@gnu.org> (raw)
In-Reply-To: <87sha21xjn.fsf@gmx.de> (message from Michael Albinus on Thu, 15 Feb 2018 09:12:28 +0100)

> From: Michael Albinus <michael.albinus@gmx.de>
> Date: Thu, 15 Feb 2018 09:12:28 +0100
> 
> The Emacs manual says in section "26.6.1 Info Documentation Lookup":
> 
> "The major mode determines where to look for documentation for the
> symbol—which Info files to look in, and which indices to search."
> 
> This is not really true. No major mode determines itself "where to look
> for information", this is hard coded in info-look.el.

I think you are misinterpreting what "determines" means in this
context.  It doesn't mean that the mode's code specifies that; it
means that Emacs determines where to look by consulting some data base
that takes the mode into account.

I will see how to reword that to avoid this ambiguity.

> Furthermore, some hard coded locations in info-look.el seem to be
> deprecated. If I, for example, choose manually autoconf-mode as symbol
> help mode, I get (taken from the *Messages* buffer):
> 
> Processing Info node ‘(m4)Macro index’...done
> Processing Info node ‘(autoconf)Autoconf Macro Index’...done
> Processing Info node ‘(autoconf)M4 Macro Index’...done
> Processing Info node ‘(autoconf)Autotest Macro Index’...done
> Processing Info node ‘(autoconf)Macro Index’...
> Cannot access Info node ‘(autoconf)Macro Index’
> Processing Info node ‘(autoconf)Macro Index’...done
> Processing Info node ‘(automake)Macro and Variable Index’...
> Cannot access Info node ‘(automake)Macro and Variable Index’
> Processing Info node ‘(automake)Macro and Variable Index’...done

I'm guessing the missing nodes do exist in some old versions of the
manuals.  I'm not sure Emacs should only support the latest versions
of each manual.  Of course, it would be good to see what replaces
those nodes in the latest manuals, and then _add_ them, but without
removing the old ones.  patches welcome.

Thanks.





      reply	other threads:[~2018-02-15 17:03 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2018-02-15  8:12 bug#30463: 26.0.91; info-lookup-symbol oddities Michael Albinus
2018-02-15 17:03 ` Eli Zaretskii [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/emacs/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=837erew5gw.fsf@gnu.org \
    --to=eliz@gnu.org \
    --cc=30463@debbugs.gnu.org \
    --cc=michael.albinus@gmx.de \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).