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

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.

Package: emacs; Severity: minor; Reported by: Glenn Morris <rgm@HIDDEN>; dated Fri, 5 May 2017 05:58:01 UTC; Maintainer for emacs is bug-gnu-emacs@HIDDEN.

Message received at submit <at> debbugs.gnu.org:


Received: (at submit) by debbugs.gnu.org; 5 May 2017 05:57:22 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri May 05 01:57:22 2017
Received: from localhost ([127.0.0.1]:55188 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1d6WF0-0001aL-8S
	for submit <at> debbugs.gnu.org; Fri, 05 May 2017 01:57:22 -0400
Received: from eggs.gnu.org ([208.118.235.92]:34005)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <rgm@HIDDEN>) id 1d6WEz-0001aA-7i
 for submit <at> debbugs.gnu.org; Fri, 05 May 2017 01:57:21 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <rgm@HIDDEN>) id 1d6WEt-0007dO-9P
 for submit <at> debbugs.gnu.org; Fri, 05 May 2017 01:57:16 -0400
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org
X-Spam-Level: 
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,RP_MATCHES_RCVD
 autolearn=disabled version=3.3.2
Received: from fencepost.gnu.org ([2001:4830:134:3::e]:45454)
 by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <rgm@HIDDEN>)
 id 1d6WEt-0007dK-5r
 for submit <at> debbugs.gnu.org; Fri, 05 May 2017 01:57:15 -0400
Received: from rgm by fencepost.gnu.org with local (Exim 4.82)
 (envelope-from <rgm@HIDDEN>)
 id 1d6WEr-0007Xh-Td; Fri, 05 May 2017 01:57:14 -0400
From: Glenn Morris <rgm@HIDDEN>
To: submit <at> debbugs.gnu.org
Subject: describe-function and autoloads not in main loaddefs
X-Spook: Jet Black out global Medco satellite imagery WMATA
X-Ran: 1N1T6/\~iw/g>,8o]d#M%%D4&.9j}-Y~B6kR=j[n3efl<@\>>bw{626?-[>y>w,p`YW:R`
X-Hue: yellow
X-Debbugs-No-Ack: yes
X-Attribution: GM
Date: Fri, 05 May 2017 01:57:13 -0400
Message-ID: <l6efw3hmme.fsf@HIDDEN>
User-Agent: Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/)
MIME-Version: 1.0
Content-Type: text/plain
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2001:4830:134:3::e
X-Spam-Score: -5.0 (-----)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -5.0 (-----)

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.





Report forwarded to bug-gnu-emacs@HIDDEN:
bug#26782; Package emacs. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Fri, 5 May 2017 06:00:02 UTC

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