From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#41727: 26.3; Doc of `define-minor-mode' and minor-mode commands Date: Sun, 7 Jun 2020 09:16:25 -0700 (PDT) Message-ID: <30c91bcf-044c-4d93-8ca8-bd407d7bd6b0@default> References: <<963d4189-17dc-4f4e-9993-0335fa271e50@default> <83k10kafha.fsf@gnu.org> <9d7f8447-1c0b-46db-a40c-c1ed2a398c46@default> <838sh081lt.fsf@gnu.org>> <<87wo4jb33s.fsf@web.de>> <<83y2oz6j6x.fsf@gnu.org>> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="56534"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 41727@debbugs.gnu.org To: Eli Zaretskii , Michael Heerdegen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Jun 07 18:19:52 2020 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jhy1X-000EbU-TN for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 07 Jun 2020 18:19:51 +0200 Original-Received: from localhost ([::1]:51458 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jhy1W-0002N2-W9 for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 07 Jun 2020 12:19:51 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:42716) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jhxyq-0001kx-D9 for bug-gnu-emacs@gnu.org; Sun, 07 Jun 2020 12:17:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:43219) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jhxyo-0000r0-Hp for bug-gnu-emacs@gnu.org; Sun, 07 Jun 2020 12:17:04 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jhxyo-00029M-EG for bug-gnu-emacs@gnu.org; Sun, 07 Jun 2020 12:17: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: Sun, 07 Jun 2020 16:17:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 41727 X-GNU-PR-Package: emacs Original-Received: via spool by 41727-submit@debbugs.gnu.org id=B41727.15915465968225 (code B ref 41727); Sun, 07 Jun 2020 16:17:02 +0000 Original-Received: (at 41727) by debbugs.gnu.org; 7 Jun 2020 16:16:36 +0000 Original-Received: from localhost ([127.0.0.1]:54765 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jhxyO-00028b-A9 for submit@debbugs.gnu.org; Sun, 07 Jun 2020 12:16:36 -0400 Original-Received: from userp2130.oracle.com ([156.151.31.86]:48964) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jhxyN-00028P-NO for 41727@debbugs.gnu.org; Sun, 07 Jun 2020 12:16:36 -0400 Original-Received: from pps.filterd (userp2130.oracle.com [127.0.0.1]) by userp2130.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 057GD2WC135906; Sun, 7 Jun 2020 16:16:30 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-2020-01-29; bh=NoWB6WYle8NnpATSw0Oo/1FSu2z6xYqFgbI0DI4qEMQ=; b=vwERta82zX2u++nuNx5pSZhTPj3wTyzQYUvI0QCi2nIBaXsnPSDfzYyjGaEH/JuZDdWC iLcZNMDdl5zSfd0aZvFtpwqtJqQUHBNLHBU2QQFTmGMFWb/b+QXYCnRfy5wfIHs+AWBC sLgPzNxmXJGws1MQorAwK93yrxBsAp82ZWnCLSu66PHMZx57uPlg6rGWk5uHl2izXoi6 XGsx21efuPiCgEK9fhmIoc4/GorqldvlVQzWSE/8Mpc35x1M53iv3WZAa4ZJvVzhoE0D MR+nkNSG6iiBxKJfcVAsOiiSn3rWdY3l2y9PB9RsOlMt2lH7TUP5JH2zdtJt6HeYI6Yq 9g== Original-Received: from aserp3030.oracle.com (aserp3030.oracle.com [141.146.126.71]) by userp2130.oracle.com with ESMTP id 31g2jqup34-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Sun, 07 Jun 2020 16:16:30 +0000 Original-Received: from pps.filterd (aserp3030.oracle.com [127.0.0.1]) by aserp3030.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 057GESPa052508; Sun, 7 Jun 2020 16:16:29 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserp3030.oracle.com with ESMTP id 31gmqk2bbg-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 07 Jun 2020 16:16:29 +0000 Original-Received: from abhmp0003.oracle.com (abhmp0003.oracle.com [141.146.116.9]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id 057GGSN0027748; Sun, 7 Jun 2020 16:16:28 GMT In-Reply-To: <<83y2oz6j6x.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.5005.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9645 signatures=668680 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 bulkscore=0 mlxscore=0 mlxlogscore=999 adultscore=0 spamscore=0 suspectscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2004280000 definitions=main-2006070124 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9645 signatures=668680 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 adultscore=0 impostorscore=0 cotscore=-2147483648 priorityscore=1501 spamscore=0 suspectscore=0 lowpriorityscore=0 bulkscore=0 mlxlogscore=999 malwarescore=0 mlxscore=0 phishscore=0 clxscore=1015 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2004280000 definitions=main-2006070124 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:181683 Archived-At: > > AFAIU Drew wants to mention that even in the noninteractive case > > `prefix-numeric-value' is called on the ARG before testing it. >=20 > If that's the essence of the bug report (and I indeed didn't realize > that), then I don't think it's a good idea to document this quirk. It > looks like an implementation detail to me, if not an outright bug that > should be fixed. If you don't document it then users won't know how to use it correctly from Lisp (at least not without studying the code). That's misleading enough to make me wonder whether, in that case, it might be better to say nothing at all about the call-from-Lisp case, forcing Lisp users to consult the code. My preference is (obviously) to have the doc tell the whole story: accurate & complete.