From unknown Fri Aug 15 20:51:07 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6496: documentation manual missing "autoload object" in "What Is a Function" node Resent-From: MON KEY Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 22 Jun 2010 22:54:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 6496 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 6496@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.127724723113596 (code B ref -1); Tue, 22 Jun 2010 22:54:02 +0000 Received: (at submit) by debbugs.gnu.org; 22 Jun 2010 22:53:51 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1ORCLn-0003XF-67 for submit@debbugs.gnu.org; Tue, 22 Jun 2010 18:53:51 -0400 Received: from mx10.gnu.org ([199.232.76.166]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1ORCLk-0003XA-JV for submit@debbugs.gnu.org; Tue, 22 Jun 2010 18:53:49 -0400 Received: from lists.gnu.org ([199.232.76.165]:56626) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1ORCLg-0000sF-N8 for submit@debbugs.gnu.org; Tue, 22 Jun 2010 18:53:44 -0400 Received: from [140.186.70.92] (port=50714 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1ORCLf-0002IQ-BA for bug-gnu-emacs@gnu.org; Tue, 22 Jun 2010 18:53:44 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=unavailable version=3.3.1 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1ORCLe-0001wc-5a for bug-gnu-emacs@gnu.org; Tue, 22 Jun 2010 18:53:43 -0400 Received: from mail-gy0-f169.google.com ([209.85.160.169]:36362) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1ORCLe-0001wM-3M for bug-gnu-emacs@gnu.org; Tue, 22 Jun 2010 18:53:42 -0400 Received: by gyg4 with SMTP id 4so4149583gyg.0 for ; Tue, 22 Jun 2010 15:53:40 -0700 (PDT) MIME-Version: 1.0 Received: by 10.150.209.12 with SMTP id h12mr6907698ybg.5.1277247218648; Tue, 22 Jun 2010 15:53:38 -0700 (PDT) Received: by 10.150.181.11 with HTTP; Tue, 22 Jun 2010 15:53:38 -0700 (PDT) Date: Tue, 22 Jun 2010 18:53:38 -0400 X-Google-Sender-Auth: dxsEfBXlq-u1q7JQ0BgH2SARcTY Message-ID: From: MON KEY Content-Type: text/plain; charset=UTF-8 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) X-Spam-Score: -5.0 (-----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -5.0 (-----) (info "(elisp)What Is a Function") Does not mention "autoload objects" as a "type" of function. It should do so and make an xref to (info "(elisp)Autoload Type"). Following is an attempt at documenting the object: ,---- | | "autoload object" | An "autoload object" stores a function definition in a placeholder | for the real definition of a symbol-function. The autoload object | says that the real definition is found in a file of Lisp code which | should be loaded when necessary. An autoload object is stored as a | list with the first element being the symbol `autoload'. | `---- The rationale for including this documentation is that both `indirect-function' and `symbol-function' will return an autoload list if the function has yet to be brought into the environment, e.g.: (when (featurep 'dunnet) (unload-feature 'dunnet)) (symbol-function 'dunnet) ;=> (autoload "dunnet" 940287 t nil) (require 'dunnet) (symbol-function 'dunnet) ;=> #[ ... ] These differences of return value w/re both `indirect-function' and `symbol-function' may be surprising to some esp. as there isn't an autoload predicate (that I'm aware of). -- /s_P\ From debbugs-submit-bounces@debbugs.gnu.org Sun Jul 03 08:34:49 2011 Received: (at control) by debbugs.gnu.org; 3 Jul 2011 12:34:49 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QdLsv-0003Nq-Et for submit@debbugs.gnu.org; Sun, 03 Jul 2011 08:34:49 -0400 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QdLst-0003Nf-Pj for control@debbugs.gnu.org; Sun, 03 Jul 2011 08:34:48 -0400 Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=quimbies.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1QdLsi-0007hE-Va for control@debbugs.gnu.org; Sun, 03 Jul 2011 14:34:37 +0200 Date: Sun, 03 Jul 2011 14:34:36 +0200 Message-Id: To: control@debbugs.gnu.org From: Lars Magne Ingebrigtsen Subject: control message for bug #6496 X-MailScanner-ID: 1QdLsi-0007hE-Va X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1310301277.10801@yvxLAJrBL+a7hcfdb4K/9A X-Spam-Status: No X-Spam-Score: -2.8 (--) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.8 (--) tags 6496 fixed close 6496 24.1 From unknown Fri Aug 15 20:51:07 2025 X-Loop: help-debbugs@gnu.org Subject: bug#6496: documentation manual missing "autoload object" in "What Is a Function" node Resent-From: Lars Magne Ingebrigtsen Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 03 Jul 2011 12:50:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 6496 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed To: MON KEY Cc: 6496@debbugs.gnu.org Received: via spool by 6496-submit@debbugs.gnu.org id=B6496.130969737417644 (code B ref 6496); Sun, 03 Jul 2011 12:50:03 +0000 Received: (at 6496) by debbugs.gnu.org; 3 Jul 2011 12:49:34 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QdM7C-0004aX-Bs for submit@debbugs.gnu.org; Sun, 03 Jul 2011 08:49:34 -0400 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QdM7A-0004aK-Oz for 6496@debbugs.gnu.org; Sun, 03 Jul 2011 08:49:33 -0400 Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=quimbies.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1QdM6z-0007us-9D; Sun, 03 Jul 2011 14:49:21 +0200 From: Lars Magne Ingebrigtsen In-Reply-To: (MON KEY's message of "Tue, 22 Jun 2010 18:53:38 -0400") Date: Sun, 03 Jul 2011 14:34:31 +0200 Message-ID: References: User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.50 (gnu/linux) X-Now-Playing: David Sylvian's _Manafon_: "Emily Dickinson" X-Hashcash: 1:23:110703:monkey@sandpframing.com::XI7dykNTcLi5qrSd:00000000000000000000000000000000000000Kcrx X-Hashcash: 1:23:110703:6496@debbugs.gnu.org::FUJUZ9MJ22ODR/t4:00000000000000000000000000000000000000000OA3n MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1QdM6z-0007us-9D X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1310302161.59424@w5sPrVmfIHnTziWVwEO1Cg X-Spam-Status: No X-Spam-Score: -2.8 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.8 (--) MON KEY writes: > Does not mention "autoload objects" as a "type" of function. > > It should do so and make an xref to (info "(elisp)Autoload Type"). > > Following is an attempt at documenting the object: > > ,---- > | > | "autoload object" > | An "autoload object" stores a function definition in a placeholder > | for the real definition of a symbol-function. The autoload object > | says that the real definition is found in a file of Lisp code which > | should be loaded when necessary. An autoload object is stored as a > | list with the first element being the symbol `autoload'. > | > `---- I've installed a similar definition in the Emacs 24 manual. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/