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#9876: 24.0.90; doc for `define-derived-mode' Date: Wed, 26 Oct 2011 10:42:27 -0700 Message-ID: <7F7835010B8546AEBC3DCEF7FFACB660@us.oracle.com> 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 1319651010 13977 80.91.229.12 (26 Oct 2011 17:43:30 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 26 Oct 2011 17:43:30 +0000 (UTC) To: 9876@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Oct 26 19:43:24 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1RJ7Vb-00033f-OY for geb-bug-gnu-emacs@m.gmane.org; Wed, 26 Oct 2011 19:43:24 +0200 Original-Received: from localhost ([::1]:44803 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RJ7Vb-0002tw-DM for geb-bug-gnu-emacs@m.gmane.org; Wed, 26 Oct 2011 13:43:23 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:41926) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RJ7VY-0002td-DS for bug-gnu-emacs@gnu.org; Wed, 26 Oct 2011 13:43:21 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RJ7VX-0007he-5S for bug-gnu-emacs@gnu.org; Wed, 26 Oct 2011 13:43:20 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:36972) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RJ7VX-0007hV-0F for bug-gnu-emacs@gnu.org; Wed, 26 Oct 2011 13:43:19 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1RJ7XC-0001GA-BN for bug-gnu-emacs@gnu.org; Wed, 26 Oct 2011 13:45:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 26 Oct 2011 17:45:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 9876 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.13196510714781 (code B ref -1); Wed, 26 Oct 2011 17:45:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 26 Oct 2011 17:44:31 +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 1RJ7Wg-0001F3-Ra for submit@debbugs.gnu.org; Wed, 26 Oct 2011 13:44:31 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RJ7We-0001Eo-5s for submit@debbugs.gnu.org; Wed, 26 Oct 2011 13:44:29 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RJ7Us-0007Yk-2t for submit@debbugs.gnu.org; Wed, 26 Oct 2011 13:42:39 -0400 Original-Received: from lists.gnu.org ([140.186.70.17]:36857) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RJ7Us-0007Yc-06 for submit@debbugs.gnu.org; Wed, 26 Oct 2011 13:42:38 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:41633) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RJ7Uq-0002Jp-A8 for bug-gnu-emacs@gnu.org; Wed, 26 Oct 2011 13:42:37 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RJ7Up-0007YK-4Q for bug-gnu-emacs@gnu.org; Wed, 26 Oct 2011 13:42:36 -0400 Original-Received: from rcsinet15.oracle.com ([148.87.113.117]:26083) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RJ7Uo-0007YC-TZ for bug-gnu-emacs@gnu.org; Wed, 26 Oct 2011 13:42:35 -0400 Original-Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by rcsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p9QHgXAe016067 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 26 Oct 2011 17:42:33 GMT Original-Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p9QHgW5I012242 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Wed, 26 Oct 2011 17:42:32 GMT Original-Received: from abhmt107.oracle.com (abhmt107.oracle.com [141.146.116.59]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p9QHgQtJ031818 for ; Wed, 26 Oct 2011 12:42:27 -0500 Original-Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 26 Oct 2011 10:42:26 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcyUBqCO0xEsd4PzSz6kkIIDcoWdyQ== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-CT-RefId: str=0001.0A090209.4EA8468A.002F,ss=1,re=0.000,fgs=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Wed, 26 Oct 2011 13:45:02 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.43 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: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:53159 Archived-At: The doc, in both the Elisp manual and the doc string, should say that parameter NAME corresponds to variable `mode-name'. Users who define major modes without using `define-derived-mode' will learn about `mode-name' and understand it when they need it or come in contact with it. Users who use only `define-derived-mode' are ignorant of this connection to the variable, unless the doc points it out. Similarly, for other variables that might be concerned - e.g., `major-mode'. Such variables should be mentioned in the doc for `d-d-m' and the connection made to its parameters. In GNU Emacs 24.0.90.1 (i386-mingw-nt5.1.2600) of 2011-10-24 on MARVIN Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.6) --no-opt --cflags -I"D:/devel/emacs/libs/libXpm-3.5.8/include" -I"D:/devel/emacs/libs/libXpm-3.5.8/src" -I"D:/devel/emacs/libs/libpng-dev_1.4.3-1/include" -I"D:/devel/emacs/libs/zlib-dev_1.2.5-2/include" -I"D:/devel/emacs/libs/giflib-4.1.4-1/include" -I"D:/devel/emacs/libs/jpeg-6b-4/include" -I"D:/devel/emacs/libs/tiff-3.8.2-1/include" -I"D:/devel/emacs/libs/gnutls-2.10.1/include" --ldflags -L"D:/devel/emacs/libs/gnutls-2.10.1/lib"'