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: Sat, 6 Jun 2020 13:39:30 -0700 (PDT) Message-ID: <89ae5145-2b1c-46c2-9e71-f296579306ba@default> References: <<963d4189-17dc-4f4e-9993-0335fa271e50@default>> <<83k10kafha.fsf@gnu.org>> <<9d7f8447-1c0b-46db-a40c-c1ed2a398c46@default>> <<838sh081lt.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="58387"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 41727@debbugs.gnu.org To: Eli Zaretskii , Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Jun 06 22:40:10 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 1jhfbu-000F4h-GA for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 06 Jun 2020 22:40:10 +0200 Original-Received: from localhost ([::1]:48368 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jhfbt-0006n2-08 for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 06 Jun 2020 16:40:09 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:49366) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jhfbm-0006mu-Pt for bug-gnu-emacs@gnu.org; Sat, 06 Jun 2020 16:40:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:41032) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jhfbm-00030m-Fc for bug-gnu-emacs@gnu.org; Sat, 06 Jun 2020 16:40:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jhfbm-00049w-Bz for bug-gnu-emacs@gnu.org; Sat, 06 Jun 2020 16:40: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, 06 Jun 2020 20:40: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.159147600115984 (code B ref 41727); Sat, 06 Jun 2020 20:40:02 +0000 Original-Received: (at 41727) by debbugs.gnu.org; 6 Jun 2020 20:40:01 +0000 Original-Received: from localhost ([127.0.0.1]:52578 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jhfbX-00049M-NM for submit@debbugs.gnu.org; Sat, 06 Jun 2020 16:40:01 -0400 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:37794) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jhfbW-000498-7Q for 41727@debbugs.gnu.org; Sat, 06 Jun 2020 16:39:46 -0400 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 056KbO5c013236; Sat, 6 Jun 2020 20:39:39 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=iYCtILekFuLdLwjGdvGVGHudoUy5SJl7gN+/S0cE25Y=; b=VCkwjXgaLi/g6vb8z3EUKlCvKk5EA64IgTaIpZ111U4EQK6jGtVRWPdXrpE/epSQPgiE Kvgo8fg6gs8oyy9Z1ttBWxSO7B16Y6s3CzU/YX5t62FGZktEf78mDAJYgnhmiN0UejON K4VnJ9r6dKioHb3F6lUBH+u7q/3Cz6VxBdK3I/Ggf8cas6j0Gq3Aq+6ui1g7kR77YLA7 2BvdeMaG7Z3tIwW74gPB0qZrD/58X9mSEyZAx79Y8Kv+TIhFrho9X9cCCaETQ89626CA Ws20n9UqxQZ9LV6M+G5DfxXnTSwfmCecwGnOUhhcOOOq92FLv3YmmHqaneBLlpRQ3z07 lg== Original-Received: from aserp3020.oracle.com (aserp3020.oracle.com [141.146.126.70]) by aserp2120.oracle.com with ESMTP id 31g33kstac-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Sat, 06 Jun 2020 20:39:39 +0000 Original-Received: from pps.filterd (aserp3020.oracle.com [127.0.0.1]) by aserp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 056KcCji117993; Sat, 6 Jun 2020 20:39:38 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserp3020.oracle.com with ESMTP id 31g2y2wkak-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 06 Jun 2020 20:39:38 +0000 Original-Received: from abhmp0011.oracle.com (abhmp0011.oracle.com [141.146.116.17]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id 056KdXNW005095; Sat, 6 Jun 2020 20:39:38 GMT In-Reply-To: <<838sh081lt.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=9644 signatures=668680 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 bulkscore=0 suspectscore=0 mlxlogscore=783 spamscore=0 malwarescore=0 adultscore=0 mlxscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2004280000 definitions=main-2006060165 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9644 signatures=668680 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 adultscore=0 spamscore=0 cotscore=-2147483648 malwarescore=0 phishscore=0 mlxscore=0 clxscore=1015 lowpriorityscore=0 impostorscore=0 priorityscore=1501 mlxlogscore=800 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2004280000 definitions=main-2006060165 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:181636 Archived-At: > My point was that you take the text out of its context, and that > context spells out what you say is missing. No, it does not. It does not at all say what I say is missing from the description of the Lisp-call behavior. > This is not the first time you raise this issue, and the argument > always goes the same way. I wish you'd stopped these repeated > complaints about the same thing. I've never made such a "complaint" before. Please point to one such, if you think doing so really adds value here. Or is your effort only to argue ad hominem, as if I'm doing something bad, and have done it "repeated"ly? How about addressing the actual bug report? You tell me how the existing text (cited by both you and me) correctly and completely describes the Lisp behavior. Passing symbol `-' isn't passing an integer, and so on. Now, if you just don't want to fix the text, that's another story. But I think you'll find it hard to argue that the report is mistaken and the text is accurate and complete. And I hope you realize that the handling of the arg to `define-minor-mode' has been the subject of a fair amount of confusion. There have been several attempts to improve the doc. But it's still not as clear and helpful as it should be. And the fix is simple: say the missing bits wrt the Lisp case. > > > Are you reading obsolete docs? > > > > I'm reading the 26.3 docs, as suggested by the report: >=20 > The latest sources seem to be different. Different from what? I stated that what you wrote is exactly the text I was referring to, verbatim. You simply added the text about the interactive case. AFAICT, we're talking about exactly the same text, in the same release, 26.3. I wonder if you're actually reading what I wrote. The text you quote is exactly the text that suffers from the problem I raised. The text about the interactive case in no way helps describe the missing parts of the case for the Lisp behavior.