From unknown Sat Jun 14 03:48:26 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#9876 <9876@debbugs.gnu.org> To: bug#9876 <9876@debbugs.gnu.org> Subject: Status: 24.0.90; doc for `define-derived-mode' Reply-To: bug#9876 <9876@debbugs.gnu.org> Date: Sat, 14 Jun 2025 10:48:26 +0000 retitle 9876 24.0.90; doc for `define-derived-mode' reassign 9876 emacs submitter 9876 "Drew Adams" severity 9876 minor tag 9876 wontfix thanks From debbugs-submit-bounces@debbugs.gnu.org Wed Oct 26 13:44:31 2011 Received: (at submit) by debbugs.gnu.org; 26 Oct 2011 17:44:31 +0000 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 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 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 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-4.7 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_MED, RP_MATCHES_RCVD,UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 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 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 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 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 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 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 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 Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 26 Oct 2011 10:42:26 -0700 From: "Drew Adams" To: Subject: 24.0.90; doc for `define-derived-mode' Date: Wed, 26 Oct 2011 10:42:27 -0700 Message-ID: <7F7835010B8546AEBC3DCEF7FFACB660@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit 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-Received-From: 140.186.70.17 X-Spam-Score: -6.2 (------) X-Debbugs-Envelope-To: submit 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: -6.2 (------) 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"' From debbugs-submit-bounces@debbugs.gnu.org Sun Sep 16 20:28:52 2012 Received: (at 9876) by debbugs.gnu.org; 17 Sep 2012 00:28:52 +0000 Received: from localhost ([127.0.0.1]:37978 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TDPCl-0006vO-CQ for submit@debbugs.gnu.org; Sun, 16 Sep 2012 20:28:51 -0400 Received: from rcsinet15.oracle.com ([148.87.113.117]:34620) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TDPCj-0006vG-7A for 9876@debbugs.gnu.org; Sun, 16 Sep 2012 20:28:49 -0400 Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by rcsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q8H0RaRI018382 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for <9876@debbugs.gnu.org>; Mon, 17 Sep 2012 00:27:37 GMT Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q8H0RaLX017964 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for <9876@debbugs.gnu.org>; Mon, 17 Sep 2012 00:27:36 GMT Received: from abhmt108.oracle.com (abhmt108.oracle.com [141.146.116.60]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q8H0RamE020266 for <9876@debbugs.gnu.org>; Sun, 16 Sep 2012 19:27:36 -0500 Received: from dradamslap1 (/10.159.170.142) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 16 Sep 2012 17:27:36 -0700 From: "Drew Adams" To: <9876@debbugs.gnu.org> References: <7F7835010B8546AEBC3DCEF7FFACB660@us.oracle.com> Subject: RE: bug#9876: 24.0.90; doc for `define-derived-mode' Date: Sun, 16 Sep 2012 17:27:25 -0700 Message-ID: <40EB3A9BA3AF427BA4122FFF401D3874@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <7F7835010B8546AEBC3DCEF7FFACB660@us.oracle.com> Thread-Index: AcyUBqCO0xEsd4PzSz6kkIIDcoWdyUAZJEtw X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-Spam-Score: -7.4 (-------) X-Debbugs-Envelope-To: 9876 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 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: -7.4 (-------) ping From debbugs-submit-bounces@debbugs.gnu.org Sun Feb 09 01:05:47 2014 Received: (at 9876) by debbugs.gnu.org; 9 Feb 2014 06:05:47 +0000 Received: from localhost ([127.0.0.1]:59035 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCNWU-0002eQ-NM for submit@debbugs.gnu.org; Sun, 09 Feb 2014 01:05:46 -0500 Received: from hermes.netfonds.no ([80.91.224.195]:39151) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCNWT-0002eI-7k for 9876@debbugs.gnu.org; Sun, 09 Feb 2014 01:05:45 -0500 Received: from [204.14.154.233] (helo=building.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1WCNWE-0006oF-VF; Sun, 09 Feb 2014 07:05:31 +0100 From: Lars Ingebrigtsen To: "Drew Adams" Subject: Re: bug#9876: 24.0.90; doc for `define-derived-mode' References: <7F7835010B8546AEBC3DCEF7FFACB660@us.oracle.com> Date: Sat, 08 Feb 2014 22:04:20 -0800 In-Reply-To: <7F7835010B8546AEBC3DCEF7FFACB660@us.oracle.com> (Drew Adams's message of "Wed, 26 Oct 2011 10:42:27 -0700") Message-ID: <87ppmw95zv.fsf@building.gnus.org> User-Agent: Gnus/5.13001 (Ma Gnus v0.10) Emacs/24.3.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1WCNWE-0006oF-VF X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1392530731.88389@aK5hHRVq7YXxdXwlN/GwGw X-Spam-Status: No X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 9876 Cc: 9876@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.0 (/) "Drew Adams" writes: > 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. I think that just sounds more confusing. The doc looks good to me the way it is. Closing. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/ From debbugs-submit-bounces@debbugs.gnu.org Sun Feb 09 01:06:37 2014 Received: (at control) by debbugs.gnu.org; 9 Feb 2014 06:06:37 +0000 Received: from localhost ([127.0.0.1]:59039 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCNXJ-0002g4-5H for submit@debbugs.gnu.org; Sun, 09 Feb 2014 01:06:37 -0500 Received: from hermes.netfonds.no ([80.91.224.195]:39157) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCNXH-0002fw-4d for control@debbugs.gnu.org; Sun, 09 Feb 2014 01:06:35 -0500 Received: from [204.14.154.233] (helo=building.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1WCNX2-0006oa-Kd for control@debbugs.gnu.org; Sun, 09 Feb 2014 07:06:21 +0100 Date: Sat, 08 Feb 2014 22:04:25 -0800 Message-Id: <87ob2g95zq.fsf@building.gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #9876 X-MailScanner-ID: 1WCNX2-0006oa-Kd X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1392530782.06709@vS/GyeP5/rPFShbO5BpA6g X-Spam-Status: No X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.0 (/) tags 9876 wontfix close 9876 From unknown Sat Jun 14 03:48:26 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 09 Mar 2014 11:24:08 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator