From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#7783: 24.0.50; (elisp) autoloading nodes, autoload cookie for define-globalized-minor-mode,... Date: Tue, 4 Jan 2011 13:34:08 -0800 Message-ID: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1294178058 531 80.91.229.12 (4 Jan 2011 21:54:18 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Tue, 4 Jan 2011 21:54:18 +0000 (UTC) To: 7783@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Jan 04 22:54:13 2011 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 1PaEpU-0006sc-As for geb-bug-gnu-emacs@m.gmane.org; Tue, 04 Jan 2011 22:54:13 +0100 Original-Received: from localhost ([127.0.0.1]:59179 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PaEpQ-0004ZI-I2 for geb-bug-gnu-emacs@m.gmane.org; Tue, 04 Jan 2011 16:54:04 -0500 Original-Received: from [140.186.70.92] (port=35474 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PaEpH-0004WW-K3 for bug-gnu-emacs@gnu.org; Tue, 04 Jan 2011 16:53:58 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PaEpA-0004NJ-Ec for bug-gnu-emacs@gnu.org; Tue, 04 Jan 2011 16:53:53 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:37637) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PaEpA-0004NF-Cq for bug-gnu-emacs@gnu.org; Tue, 04 Jan 2011 16:53:48 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1PaERC-00068N-5i; Tue, 04 Jan 2011 16:29:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 04 Jan 2011 21:29:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 7783 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.129417652323554 (code B ref -1); Tue, 04 Jan 2011 21:29:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 4 Jan 2011 21:28:43 +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 1PaEQt-00067q-AO for submit@debbugs.gnu.org; Tue, 04 Jan 2011 16:28:43 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PaEQq-00067d-LH for submit@debbugs.gnu.org; Tue, 04 Jan 2011 16:28:41 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PaEXl-0000dh-FH for submit@debbugs.gnu.org; Tue, 04 Jan 2011 16:35:50 -0500 Original-Received: from lists.gnu.org ([199.232.76.165]:34471) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PaEXl-0000dd-CV for submit@debbugs.gnu.org; Tue, 04 Jan 2011 16:35:49 -0500 Original-Received: from [140.186.70.92] (port=58081 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PaEXj-0005HI-Kz for bug-gnu-emacs@gnu.org; Tue, 04 Jan 2011 16:35:49 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PaEXi-0000ci-8m for bug-gnu-emacs@gnu.org; Tue, 04 Jan 2011 16:35:47 -0500 Original-Received: from rcsinet10.oracle.com ([148.87.113.121]:65249) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PaEXi-0000cN-2I for bug-gnu-emacs@gnu.org; Tue, 04 Jan 2011 16:35:46 -0500 Original-Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id p04LZffT028785 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Tue, 4 Jan 2011 21:35:43 GMT Original-Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155]) by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id p04LCkTe010890 for ; Tue, 4 Jan 2011 21:35:41 GMT Original-Received: from abhmt018.oracle.com by acsmt353.oracle.com with ESMTP id 898612551294176841; Tue, 04 Jan 2011 13:34:01 -0800 Original-Received: from dradamslap1 (/10.159.216.166) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 04 Jan 2011 13:34:01 -0800 X-Mailer: Microsoft Office Outlook 11 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5994 Thread-Index: AcusVx5TMCP9qb4qQCSN6kFKZ+a63A== X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Tue, 04 Jan 2011 16:29:02 -0500 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:43085 Archived-At: emacs -Q C-h i, choose Elisp Search for autoload. The first occurrence is `Autoload Type', in subsection `Programming Types'. The second occurrence is `Autoloading', in subsection `Kinds of Forms'. It is supposed to be a node on "Functions set up to load files containing their real definitions" ("their" is not super clear). So the main menu entry for `Autoloading' is that node. Continuing to search in the top-level menu we come to `Autoload' in subsection `Loading'. So we see that there are at least 3 nodes with very similar node names: `Autoload Type', `Autoloading', and `Autoload'. The first part of this bug is that the names should be more specific, referring to the topics of their relative subsections or some other specificity. Next, follow the menu link to node `Autoloading'. It is not, as the main menu said, a node that describes or explains "Functions set up to load files containing their real definitions". It is a node that is nearly vacuous of content. It simply gives some general blah-blah about autoloading and then sends you off to node `Autoload'. So the second part of this bug is to clean this up - either get rid of this node or DTRT wrt its purported topic (and rename it, since the name is too general for the topic). Following that link we finally get to node `Autoload', which is where autoloading is explained. There should be a top-level, main menu entry to this node, and not just a link buried in some subsection (let along 3 links in 3 subsections). Finally, in node `Autoload' we say that these constructs are handled by cookies: "Function-defining forms" include `define-skeleton', `define-derived-mode', `define-generic-mode' and `define-minor-mode' as well as `defun' and `defmacro'. What about `define-globalized-minor-mode'? If that is not handled similarly, then that is a code bug - it should be. If it is handled similarly by a cookie then it should be included in the doc list. Users should not need to consult the source code to try to determine what an autoload cookie before `define-globalized-minor-mode' will do. In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600) of 2011-01-03 on 3249CTO Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.4) --no-opt --cflags -Ic:/imagesupport/include' Important settings: value of $LC_ALL: nil value of $LC_COLLATE: nil value of $LC_CTYPE: nil value of $LC_MESSAGES: nil value of $LC_MONETARY: nil value of $LC_NUMERIC: nil value of $LC_TIME: nil value of $LANG: ENU value of $XMODIFIERS: nil locale-coding-system: cp1252 default enable-multibyte-characters: t Major mode: Info Minor modes in effect: tooltip-mode: t mouse-wheel-mode: t tool-bar-mode: t menu-bar-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t blink-cursor-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t line-number-mode: t transient-mark-mode: t Recent input: C-h i C-s a u t o l o a d C-s l Recent messages: For information about GNU Emacs and the GNU system, type C-h C-a. Composing main Info directory...done Mark saved where search started Load-path shadows: c:/Emacs-24-2011-01-03/lisp/emacs-lisp/sregex hides c:/Emacs-24-2011-01-03/lisp/obsolete/sregex c:/Emacs-24-2011-01-03/lisp/pgg hides c:/Emacs-24-2011-01-03/lisp/obsolete/pgg c:/Emacs-24-2011-01-03/lisp/pgg-pgp5 hides c:/Emacs-24-2011-01-03/lisp/obsolete/pgg-pgp5 c:/Emacs-24-2011-01-03/lisp/pgg-pgp hides c:/Emacs-24-2011-01-03/lisp/obsolete/pgg-pgp c:/Emacs-24-2011-01-03/lisp/pgg-parse hides c:/Emacs-24-2011-01-03/lisp/obsolete/pgg-parse c:/Emacs-24-2011-01-03/lisp/pgg-gpg hides c:/Emacs-24-2011-01-03/lisp/obsolete/pgg-gpg c:/Emacs-24-2011-01-03/lisp/pgg-def hides c:/Emacs-24-2011-01-03/lisp/obsolete/pgg-def Features: (shadow sort gnus-util mail-extr message rfc822 mml mml-sec mm-decode mm-bodies mm-encode mail-parse rfc2231 rfc2047 rfc2045 ietf-drums mm-util mail-prsvr mailabbrev mail-utils gmm-utils mailheader emacsbug multi-isearch info easymenu dired regexp-opt tooltip ediff-hook vc-hooks lisp-float-type mwheel dos-w32 disp-table ls-lisp w32-win w32-vars tool-bar dnd fontset image fringe lisp-mode register page menu-bar rfn-eshadow timer select scroll-bar mouse jit-lock font-lock syntax facemenu font-core frame cham georgian utf-8-lang misc-lang vietnamese tibetan thai tai-viet lao korean japanese hebrew greek romanian slovak czech european ethiopic indian cyrillic chinese case-table epa-hook jka-cmpr-hook help simple abbrev button minibuffer faces cus-face files text-properties overlay md5 base64 format env code-pages mule custom widget hashtable-print-readable backquote make-network-process multi-tty emacs)