From unknown Sun Jun 22 03:58:50 2025 X-Loop: help-debbugs@gnu.org Subject: bug#20531: 25.0.50; doc string of `define-derived-mode': NAME Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 08 May 2015 16:35:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 20531 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 20531@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.14311028667875 (code B ref -1); Fri, 08 May 2015 16:35:03 +0000 Received: (at submit) by debbugs.gnu.org; 8 May 2015 16:34:26 +0000 Received: from localhost ([127.0.0.1]:38928 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YqlEH-00022x-5n for submit@debbugs.gnu.org; Fri, 08 May 2015 12:34:25 -0400 Received: from eggs.gnu.org ([208.118.235.92]:43494) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YqlEF-00022k-61 for submit@debbugs.gnu.org; Fri, 08 May 2015 12:34:23 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YqlE9-00015C-5u for submit@debbugs.gnu.org; Fri, 08 May 2015 12:34:17 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:57879) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YqlE9-000158-3O for submit@debbugs.gnu.org; Fri, 08 May 2015 12:34:17 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:56996) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YqlE8-0006qQ-9N for bug-gnu-emacs@gnu.org; Fri, 08 May 2015 12:34:17 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YqlE3-00013q-Bg for bug-gnu-emacs@gnu.org; Fri, 08 May 2015 12:34:16 -0400 Received: from userp1040.oracle.com ([156.151.31.81]:20739) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YqlE3-00012Z-4B for bug-gnu-emacs@gnu.org; Fri, 08 May 2015 12:34:11 -0400 Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t48GY9JO018838 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Fri, 8 May 2015 16:34:10 GMT Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by aserv0021.oracle.com (8.13.8/8.13.8) with ESMTP id t48GY9t9007894 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL) for ; Fri, 8 May 2015 16:34:09 GMT Received: from abhmp0007.oracle.com (abhmp0007.oracle.com [141.146.116.13]) by aserv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t48GY97P021059 for ; Fri, 8 May 2015 16:34:09 GMT MIME-Version: 1.0 Message-ID: Date: Fri, 8 May 2015 09:34:08 -0700 (PDT) From: Drew Adams X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0021.oracle.com [141.146.126.233] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 208.118.235.17 X-Spam-Score: -4.0 (----) 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: -4.0 (----) The description of NAME refers to the "status line". There is no such thing in Emacs (unless you define that term here). Presumably, what is meant is a particular portion of the mode line, such as is given by `mode-line-modes'. In GNU Emacs 25.0.50.1 (i686-pc-mingw32) of 2014-10-20 on LEG570 Bzr revision: 118168 rgm@gnu.org-20141020195941-icp42t8ttcnud09g Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --enable-checking=3Dyes,glyphs CPPFLAGS=3D-DGLYPH_DEBUG=3D1' From debbugs-submit-bounces@debbugs.gnu.org Sat Apr 30 15:16:10 2016 Received: (at control) by debbugs.gnu.org; 30 Apr 2016 19:16:10 +0000 Received: from localhost ([127.0.0.1]:58428 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1awaN8-0005we-K2 for submit@debbugs.gnu.org; Sat, 30 Apr 2016 15:16:10 -0400 Received: from hermes.netfonds.no ([80.91.224.195]:59793) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1awaN7-0005wV-Tp for control@debbugs.gnu.org; Sat, 30 Apr 2016 15:16:10 -0400 Received: from cm-84.215.1.64.getinternet.no ([84.215.1.64] helo=mouse) by hermes.netfonds.no with esmtpsa (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.84_2) (envelope-from ) id 1awaN5-0005pC-R0 for control@debbugs.gnu.org; Sat, 30 Apr 2016 21:16:09 +0200 Date: Sat, 30 Apr 2016 21:16:07 +0200 Message-Id: <87lh3udi14.fsf@gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #20531 X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 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 (/) forcemerge 20531 17567 From debbugs-submit-bounces@debbugs.gnu.org Sat Sep 25 13:15:25 2021 Received: (at control) by debbugs.gnu.org; 25 Sep 2021 17:15:25 +0000 Received: from localhost ([127.0.0.1]:34557 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mUBGm-0004fT-Ou for submit@debbugs.gnu.org; Sat, 25 Sep 2021 13:15:24 -0400 Received: from mail-pl1-f177.google.com ([209.85.214.177]:35788) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mUBGl-0004f8-27 for control@debbugs.gnu.org; Sat, 25 Sep 2021 13:15:23 -0400 Received: by mail-pl1-f177.google.com with SMTP id bb10so8742406plb.2 for ; Sat, 25 Sep 2021 10:15:23 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:in-reply-to:references:user-agent :mime-version:date:message-id:subject:to:cc; bh=6C5qdby65KdUvXvWOdLlpKDaXlDtcjdOUfrMdspTCko=; b=DPiIDr/VSZBkzl7b/fO8nX4V2t3E984VsMSgsIphyR5MDuwHZFVHjqsL7hKuJrxvDY xAHOmjkIbReVUL59g08caul0hNOH/j0Apt1KCvJF4GDXZrWIJvWBrv0nVTQaDnIi4P7q 5HPd2PD57+6xgco90luuC/th+kBgbcUicQAGVt1SjwhQyzrHPPNSq5k7LfavSdbgMbO5 zoceSQs/XxLNHh8WDGxLW239jCdHajyCWAcLurZqjI8BOKHsFonqDUToUy2pc2mdYvU+ /rXTjzlOxVpO6NZu1izawdDcc1CBnxq6cowtVAYDeypxug9t/Xn7eETxUQ7037O7lHGH Ddiw== X-Gm-Message-State: AOAM533wcZ2/UcU09O2PtKnqqMOdA5qQdipTlMiHCkKUK7lpoWDxUc4u /+Q5rhATccla8AtDmD6nx7DcvuBbiMMaiui5qjo2DsduC20= X-Google-Smtp-Source: ABdhPJyipXHY8qLnndxSaNWRy5osCCcVUXd/tJxZZmi6Csxdzlvn9ehr4DTZ6jBmz/U42SB8wl8sGkfhCPR33P0KATo= X-Received: by 2002:a17:90a:460a:: with SMTP id w10mr9235849pjg.132.1632590117283; Sat, 25 Sep 2021 10:15:17 -0700 (PDT) Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sat, 25 Sep 2021 10:15:16 -0700 From: Stefan Kangas In-Reply-To: <8e27e542-96e8-4342-a761-8c066fe3d307@default> (Drew Adams's message of "Fri, 23 May 2014 12:35:53 -0700 (PDT)") References: <8e27e542-96e8-4342-a761-8c066fe3d307@default> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) MIME-Version: 1.0 Date: Sat, 25 Sep 2021 10:15:16 -0700 Message-ID: Subject: Re: bug#17567: 24.4.50; doc string of `define-derived-mode' To: Drew Adams Content-Type: text/plain; charset="UTF-8" Bcc: control@debbugs.gnu.org X-Spam-Score: 0.5 (/) X-Debbugs-Envelope-To: control Cc: 17567@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 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.5 (/) tags 17567 + fixed close 17567 28.1 thanks Drew Adams writes: > The doc string erroneously says that parameter NAME is "a string > which will appear in the status line". > > Emacs does not have a "status line". That term is used nowhere. > > What should be said about NAME is that it defines the value of variable > `mode-name' for mode CHILD. A user consulting that variable will see > that its value is used in the mode line etc. Drew Adams writes: > Also, the doc string should state the types of the values of > keywords :group, :syntax-table, and :abbrev-table. > > And it says that the mode runs the hook constructed by function > `derived-mode-hook-name'. Constructed how? What does constructed > mean here? > > And the doc string of `derived-mode-hook-name' is no help here: > "Construct a mode-hook name based on a MODE name." > > The arg is MODE. What is it? What data type? And what is > its "name"? What does it mean to construct a hook name? > And how is that name constructed from the "MODE name"? > > And what about the contradiction between the doc string of > `define-derived-mode' and that of `derived-mode-hook-name'? > The former says that `d-m-h-name' constructs a _hook_. The > latter says that it constructs a hook _name_. > > Far clearer for `derived-mode-hook-name' would be to just > say what it really does: > > Return a symbol whose name is "-hook" appended to the > `symbol-name' of MODE. > > That also makes it clear that MODE is expected to be a symbol. > > (Similarly, for the other `defsubst's in derived.el.) I have now fixed this on (commit e4c9081d46). This change will be a part of the upcoming Emacs 28.1. Please verify that this fix works for you, but for now I'm closing this bug report. If you see anything that is wrong, please reply to this email (use "Reply to all" in your email client) and we can reopen the bug report. You could also just report a new bug. Thanks again for the bug report!