From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#26301: 24.5; `define-derived-mode': different signatures for doc string & manual Date: Sat, 27 Jul 2019 09:54:45 -0700 (PDT) Message-ID: <7e2203c3-0855-4716-9700-d2b31b4cc4ba@default> References: <8cad00f7-f86e-4d12-ad36-05214708aff1@default> <8736itnjkk.fsf@mouse.gnus.org> <855znokfrs.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="13771"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 26301@debbugs.gnu.org To: Lars Ingebrigtsen , Noam Postavsky Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Jul 27 18:55: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 1hrPyO-0003TL-An for geb-bug-gnu-emacs@m.gmane.org; Sat, 27 Jul 2019 18:55:08 +0200 Original-Received: from localhost ([::1]:46646 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hrPyN-0006tU-D2 for geb-bug-gnu-emacs@m.gmane.org; Sat, 27 Jul 2019 12:55:07 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:48224) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hrPyJ-0006sx-Lx for bug-gnu-emacs@gnu.org; Sat, 27 Jul 2019 12:55:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hrPyI-0007Rm-Q7 for bug-gnu-emacs@gnu.org; Sat, 27 Jul 2019 12:55:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:36504) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hrPyI-0007Rh-N3 for bug-gnu-emacs@gnu.org; Sat, 27 Jul 2019 12:55:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hrPyI-0005ZT-G1 for bug-gnu-emacs@gnu.org; Sat, 27 Jul 2019 12:55:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 27 Jul 2019 16:55: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.156424649721399 (code B ref 26301); Sat, 27 Jul 2019 16:55:02 +0000 Original-Received: (at 26301) by debbugs.gnu.org; 27 Jul 2019 16:54:57 +0000 Original-Received: from localhost ([127.0.0.1]:45325 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hrPyC-0005Z5-PI for submit@debbugs.gnu.org; Sat, 27 Jul 2019 12:54:56 -0400 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:35744) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hrPyA-0005Yr-Ha for 26301@debbugs.gnu.org; Sat, 27 Jul 2019 12:54:54 -0400 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x6RGs3lc095825; Sat, 27 Jul 2019 16:54:48 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=APMWJmX3qXWzaQhBPt02UJy9SaiquEsy14tmlxzqF6c=; b=E1iAGy2VRebg76gLWJGKk2863XEc8yGV0vjkd6yTSAVdoNP38enOs2LL8CET6yoVqOqG uYjygjNo6gF7XMyAAdQaSWOww5H5RjSAE6WNRXthi6uV9IILFHegXTpnq58kLkCKDvZ2 WGylcOIf8RzLa5ER9K79M8y6zWqgFBpT1OQRGTguS5wBNXZcHxVgSqaKSVGUtLftxwaQ /4CWG7nr7w3RU8XAmeKhMgXXSqb5PhUUc6sRrtrv2fUnYj/6w8yqTMAbqEiRwNML70Lz ZhDX0YbkjzQWpFfppieA5XD3UJBAeJkfk8ydzAR+l906xMRjp1cISvI5fX3aDhOWCF83 pA== Original-Received: from aserp3020.oracle.com (aserp3020.oracle.com [141.146.126.70]) by aserp2120.oracle.com with ESMTP id 2u0ejp1jut-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 27 Jul 2019 16:54:48 +0000 Original-Received: from pps.filterd (aserp3020.oracle.com [127.0.0.1]) by aserp3020.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x6RGmNks079617; Sat, 27 Jul 2019 16:54:48 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserp3020.oracle.com with ESMTP id 2u0ee2yr9d-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 27 Jul 2019 16:54:48 +0000 Original-Received: from abhmp0012.oracle.com (abhmp0012.oracle.com [141.146.116.18]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id x6RGsk32022973; Sat, 27 Jul 2019 16:54:46 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4873.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9331 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=685 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1906280000 definitions=main-1907270212 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9331 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=740 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1906280000 definitions=main-1907270213 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:163903 Archived-At: > \(fn CHILD PARENT NAME [DOCSTRING] [KEYWORDS...] &rest BODY) >=20 > 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. It is not _keywords_, which is presumably a _list_ of keywords (or more exactly, keyword key-value pairs), that is repeated. What is optional is not a list of lists. What is optional is a list of keywords (or more exactly...). The name should be KEYWORD or KEYWORD-ENTRY or KEYWORD-PAIR or some such. It should not be KEYWORDS.