GNU bug report logs - #26782
describe-function and autoloads not in main loaddefs

Previous Next

To reply to this bug, email your comments to 26782 AT debbugs.gnu.org.

Toggle the display of automated, internal messages from the tracker.

Message #3 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Glenn Morris <rgm <at> gnu.org>
To: submit <at> debbugs.gnu.org
Subject: describe-function and autoloads not in main loaddefs
Date: Fri, 05 May 2017 01:57:13 -0400

Package: emacs
Version: 25.2
Severity: minor

emacs -Q -l cl-lib
C-h f cl-assoc
 -> "cl-assoc is an autoloaded Lisp function..."

This creates the confusing impression that you can expect to use
cl-assoc (eg) in emacs -Q. But you can't, because while it does have an
autoload cookie, it's in a file with generated-autoload-file non-nil, so
the autoloads don't go into the main loaddefs.el file. The autoload is
just an internal implementation detail of cl-lib that users should not
be concerned about. The same applies for other places that set
generated-autoload-file non-nil; eg rmail-add-label.

Perhaps the "autoloaded" bit should not be included in the
describe-function output if the autoload isn't in the main loaddefs
file. Or maybe it should be qualified somehow, though I'm not sure it
would be useful information.

The issue is going to get even more confusing in Emacs 26.1, where the
new definition-prefixes feature means that you don't even have to
explicitly load the main library any more. Eg:

emacs-25.2 -Q -l rmail
C-h f rmail- TAB
rmail-add-label
-> "rmail-add-label is an interactive autoloaded Lisp function"

In Emacs 26.1, you won't even need the "-l rmail" to get rmail-add-label
returned as a completion.

Message #6 received at 26782 <at> debbugs.gnu.org (full text, mbox):

From: Glenn Morris <rgm <at> gnu.org>
To: 26782 <at> debbugs.gnu.org
Subject: Re: bug#26782: describe-function and autoloads not in main loaddefs
Date: Wed, 17 May 2017 14:01:54 -0400

The simplest solution would be to just remove the "autoloaded" text.
It was added when help-enable-auto-load was added, so that you could
tell if C-h f had auto-loaded the function definition. Since nowadays
C-h f will unconditionally load even non-autoloaded things via
definition-prefixes, maybe it's no longer useful to add the "autoloaded"
text.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.