From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: MON KEY Newsgroups: gmane.emacs.bugs Subject: bug#6496: documentation manual missing "autoload object" in "What Is a Function" node Date: Tue, 22 Jun 2010 18:53:38 -0400 Message-ID: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 X-Trace: dough.gmane.org 1277247555 8446 80.91.229.12 (22 Jun 2010 22:59:15 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Tue, 22 Jun 2010 22:59:15 +0000 (UTC) To: 6496@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Jun 23 00:59:14 2010 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1ORCQz-0007JZ-TZ for geb-bug-gnu-emacs@m.gmane.org; Wed, 23 Jun 2010 00:59:14 +0200 Original-Received: from localhost ([127.0.0.1]:34098 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1ORCQz-00037X-4t for geb-bug-gnu-emacs@m.gmane.org; Tue, 22 Jun 2010 18:59:13 -0400 Original-Received: from [140.186.70.92] (port=33699 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1ORCQm-00031z-Ha for bug-gnu-emacs@gnu.org; Tue, 22 Jun 2010 18:59:01 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1ORCQl-0003nd-BP for bug-gnu-emacs@gnu.org; Tue, 22 Jun 2010 18:59:00 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:54492) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1ORCQl-0003nY-A4 for bug-gnu-emacs@gnu.org; Tue, 22 Jun 2010 18:58:59 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1ORCLy-0003XV-IU; Tue, 22 Jun 2010 18:54:02 -0400 X-Loop: help-debbugs@gnu.org 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: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.127724723113596 (code B ref -1); Tue, 22 Jun 2010 22:54:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 22 Jun 2010 22:53:51 +0000 Original-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 Original-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 Original-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 Original-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 Original-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 Original-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 Original-Received: by gyg4 with SMTP id 4so4149583gyg.0 for ; Tue, 22 Jun 2010 15:53:40 -0700 (PDT) Original-Received: by 10.150.209.12 with SMTP id h12mr6907698ybg.5.1277247218648; Tue, 22 Jun 2010 15:53:38 -0700 (PDT) Original-Received: by 10.150.181.11 with HTTP; Tue, 22 Jun 2010 15:53:38 -0700 (PDT) X-Google-Sender-Auth: dxsEfBXlq-u1q7JQ0BgH2SARcTY 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-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Tue, 22 Jun 2010 18:54:02 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:37957 Archived-At: (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\