From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#10909: 24.0.94; doc of `define-minor-mode' Date: Tue, 28 Feb 2012 18:54:47 -0800 Message-ID: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1330484184 11079 80.91.229.3 (29 Feb 2012 02:56:24 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 29 Feb 2012 02:56:24 +0000 (UTC) To: 10909@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Feb 29 03:56:24 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1S2ZiJ-0002Vp-H0 for geb-bug-gnu-emacs@m.gmane.org; Wed, 29 Feb 2012 03:56:23 +0100 Original-Received: from localhost ([::1]:44052 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1S2ZiI-0008Nt-Sg for geb-bug-gnu-emacs@m.gmane.org; Tue, 28 Feb 2012 21:56:22 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:59838) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1S2ZiE-0008IB-L3 for bug-gnu-emacs@gnu.org; Tue, 28 Feb 2012 21:56:19 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1S2ZiC-0001zU-Ng for bug-gnu-emacs@gnu.org; Tue, 28 Feb 2012 21:56:18 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:48124) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1S2ZiC-0001z9-KB for bug-gnu-emacs@gnu.org; Tue, 28 Feb 2012 21:56:16 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1S2Zhy-0007LR-8x for bug-gnu-emacs@gnu.org; Tue, 28 Feb 2012 21:56:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 29 Feb 2012 02:56:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 10909 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.133048413128193 (code B ref -1); Wed, 29 Feb 2012 02:56:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 29 Feb 2012 02:55:31 +0000 Original-Received: from localhost ([127.0.0.1]:54956 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1S2ZhS-0007KU-T4 for submit@debbugs.gnu.org; Tue, 28 Feb 2012 21:55:31 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:55005) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1S2ZhH-0007K8-EF for submit@debbugs.gnu.org; Tue, 28 Feb 2012 21:55:19 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1S2Zgz-0001H6-Hm for submit@debbugs.gnu.org; Tue, 28 Feb 2012 21:55:02 -0500 Original-Received: from lists.gnu.org ([208.118.235.17]:39430) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1S2Zgz-0001Fu-Dq for submit@debbugs.gnu.org; Tue, 28 Feb 2012 21:55:01 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:59502) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1S2Zgx-00083G-Kl for bug-gnu-emacs@gnu.org; Tue, 28 Feb 2012 21:55:00 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1S2Zgv-0001CY-EX for bug-gnu-emacs@gnu.org; Tue, 28 Feb 2012 21:54:58 -0500 Original-Received: from acsinet15.oracle.com ([141.146.126.227]:32872) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1S2Zgv-0001BH-8O for bug-gnu-emacs@gnu.org; Tue, 28 Feb 2012 21:54:57 -0500 Original-Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by acsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q1T2srCf005397 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 29 Feb 2012 02:54:54 GMT Original-Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q1T2srTB006742 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Wed, 29 Feb 2012 02:54:53 GMT Original-Received: from abhmt103.oracle.com (abhmt103.oracle.com [141.146.116.55]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q1T2srDi023648 for ; Tue, 28 Feb 2012 20:54:53 -0600 Original-Received: from dradamslap1 (/10.159.42.251) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 28 Feb 2012 18:54:52 -0800 X-Mailer: Microsoft Office Outlook 11 Thread-Index: Acz2jX8aj4euog+7TJqxtjzjTSwxzA== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090203.4F4D937E.006C,ss=1,re=0.000,fgs=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.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-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:57385 Archived-At: The doc says that the mode function that gets defined accepts an optional argument. The interactive description is OK. The non-interactive description says only "When called from Lisp, it enables the mode if the argument is omitted or nil, and toggles the mode if the argument is `toggle'." IOW, it says nothing about what happens when an arg is passed that is not nil or omitted or `toggle'. And I've seen at least one user try to use `(foo-mode t)'. It turns out that that has the same effect as `(foo-mode 1)', but nothing in the doc says that it should. The doc should, at a minimum, say what kinds of non-nil arguments it expects (e.g. integer). Personally, I think it should probably go beyond that and say also what it does with other non-nil args, but that's your call. In GNU Emacs 24.0.94.1 (i386-mingw-nt5.1.2600) of 2012-02-26 on MARVIN Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.6) --no-opt --enable-checking --cflags -ID:/devel/emacs/libs/libXpm-3.5.8/include -ID:/devel/emacs/libs/libXpm-3.5.8/src -ID:/devel/emacs/libs/libpng-dev_1.4.3-1/include -ID:/devel/emacs/libs/zlib-dev_1.2.5-2/include -ID:/devel/emacs/libs/giflib-4.1.4-1/include -ID:/devel/emacs/libs/jpeg-6b-4/include -ID:/devel/emacs/libs/tiff-3.8.2-1/include -ID:/devel/emacs/libs/gnutls-3.0.9/include'