From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Michael Heerdegen Newsgroups: gmane.emacs.bugs Subject: bug#26301: 24.5; `define-derived-mode': different signatures for doc string & manual Date: Sun, 28 Jul 2019 00:19:27 +0200 Message-ID: <87zhkzdssw.fsf@web.de> References: <8cad00f7-f86e-4d12-ad36-05214708aff1@default> <8736itnjkk.fsf@mouse.gnus.org> <855znokfrs.fsf@gmail.com> <7e2203c3-0855-4716-9700-d2b31b4cc4ba@default> Mime-Version: 1.0 Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="213664"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: Lars Ingebrigtsen , Noam Postavsky , 26301@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jul 28 00:20:09 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hrV2u-000tSk-Pu for geb-bug-gnu-emacs@m.gmane.org; Sun, 28 Jul 2019 00:20:09 +0200 Original-Received: from localhost ([::1]:47488 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hrV2t-0002Ja-1Z for geb-bug-gnu-emacs@m.gmane.org; Sat, 27 Jul 2019 18:20:07 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:35900) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hrV2p-0002JO-Qu for bug-gnu-emacs@gnu.org; Sat, 27 Jul 2019 18:20:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hrV2o-0000fy-U1 for bug-gnu-emacs@gnu.org; Sat, 27 Jul 2019 18:20:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:36712) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hrV2o-0000fR-Mr for bug-gnu-emacs@gnu.org; Sat, 27 Jul 2019 18:20:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hrV2o-0002jJ-H7 for bug-gnu-emacs@gnu.org; Sat, 27 Jul 2019 18:20:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Michael Heerdegen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 27 Jul 2019 22:20:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 26301 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed Original-Received: via spool by 26301-submit@debbugs.gnu.org id=B26301.156426598610465 (code B ref 26301); Sat, 27 Jul 2019 22:20:02 +0000 Original-Received: (at 26301) by debbugs.gnu.org; 27 Jul 2019 22:19:46 +0000 Original-Received: from localhost ([127.0.0.1]:45533 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hrV2X-0002ij-QJ for submit@debbugs.gnu.org; Sat, 27 Jul 2019 18:19:46 -0400 Original-Received: from mout.web.de ([217.72.192.78]:53741) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hrV2W-0002iV-Vt for 26301@debbugs.gnu.org; Sat, 27 Jul 2019 18:19:45 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=web.de; s=dbaedf251592; t=1564265969; bh=VXdTelxAlWerrYSVCODls3HNlrplcNc0UCP07E85aSA=; h=X-UI-Sender-Class:From:To:Cc:Subject:References:Date:In-Reply-To; b=WouwquA7+xD0EpJGUJjlePrn8WUk5Kx64xsxzoVQ3lbrwQm5JURzIEB60ONoaAd7Q qWoOzFU4nGs1BNrWwMFxHT6vbx+QaKkz9kgAMJSf6PO1ohlYgCfMzeajOFMplty/in TC+sKvfz4ZLs/WgOlIVsRQiyyWF+O3SwLSKeqkNw= X-UI-Sender-Class: c548c8c5-30a9-4db5-a2e7-cb6cb037b8f9 Original-Received: from drachen.dragon ([92.208.178.242]) by smtp.web.de (mrweb101 [213.165.67.124]) with ESMTPSA (Nemesis) id 0Maamb-1i75wm3FsH-00K6ny; Sun, 28 Jul 2019 00:19:29 +0200 In-Reply-To: <7e2203c3-0855-4716-9700-d2b31b4cc4ba@default> (Drew Adams's message of "Sat, 27 Jul 2019 09:54:45 -0700 (PDT)") X-Provags-ID: V03:K1:7lqfjAs713D4vlZkL8zPfbvBFQ7DmTW+RHNJQeehfQ8oNJx62ww f4nEpkelvu0FdqhyXTh3pn4a9SiqCECxnu1QzBemBbmx5DDNpcfGBMmZB9jmrF1CKlNjiwU gwtdQoRG/HyZRHplT4NR9I0F3/Q5q9Koc3SnKlF9b7xDQ8pDk6ScgLfdQAwnYm99kck87dI KgoDe9Vyf4CnWTfW/Kymw== X-UI-Out-Filterresults: notjunk:1;V03:K0:9veH9ctY160=:fW84OmU5Nl2KQx1RwK39V5 dN/1G5jnNkUafmFYtOK+QSXntyPs2+knNrTqLkFhdpU2MQ7CpEyvOSVa3k1Qfh5uGu3kUWGpx 06EL3KCAgWy8OGQ/9hSyp3sPGrfExkJApZhmhgE/27ydR1n/UShwik45f/IVNJnHwYItXX4pA 0uHXYekjeqAYC2IRlhb3JYNORaCdw0pwF6B1zSCzA/l/PFmQcSg2tMYVKK8ByIr5hIXb+UvjA tIuTbkfoKTaMEkDMimPAB7ReMfkAflnD4YqEt7YGUDMYNuTMf0eV/2uWzoyiNFQBFf3OpLcU+ uXhL+rHy1UU2q5rMO27Kmko00A1oT5ZVyLQDYld2U5JqQUPtHspf6L/eLD78DoO7WpJ0LXPy2 jejNWmSN8rsf0JXJmjMEBB6fZYjRFw9Qb6WC2bDV/1G3XjXFb2ldBhQCz//6Ym/7uV1gYkN/+ xStgBg+fAm/sPcXJ5JpcHEMc4PO+5ol2n3J0SeFHedf65g6kVGkLBpxWJzliXA/Ghw2XhGfEA whgIotFnnoadSBxz6u+LlaGRNrb6XwEQaw25mgXwgVhQ06cI37/Yu+dPNnw0WBfRvQgI2Jp45 qI6J1VK7aL5D5jrqMmGPZwV9a7xsebC1WQ9vFHLErVVq8OUSvyoVaitqQkgPPqyj0PfY99GCX 2sbnDcG1tryZ2iFx/23QBjCWkkDCDipqQoE0W/FKOUxrakzbFDcQUJhOXn1F1Je/pip1Kk/6+ GWjOkLcCo5hkocxswaW4W2MBg06So0mMD920qnr0V6CNqhM0lNi5hfjDdTsatxiShuTzZUEz X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.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" Xref: news.gmane.org gmane.emacs.bugs:163916 Archived-At: Drew Adams writes: > > \(fn CHILD PARENT NAME [DOCSTRING] [KEYWORDS...] &rest BODY) > > > > So I've now done this and adjusted the rest of the doc string > > accordingly. > > Sounds good. That's what I suggested, but with the > addition of the `...' (good). > > However, in that case, KEYWORDS is the _wrong_ name. In a similar case, `define-globalized-minor-mode' uses the name KEYS (it's the name of the &rest arg though). > The name should be KEYWORD or KEYWORD-ENTRY or KEYWORD-PAIR or some > such. I all find that not better. KEYWORD fails to say that values are included. KEYWORD-ENTRY and KEYWORD-PAIR are confising, they make it look like you would have to specify conses or two element lists. I would prefer something like [KEYWORD VALUE ...], though I guess that would then confuse eldoc. Michael.