From unknown Sat Jun 14 19:38:39 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25428: 25.1; Incorrect doc string for `delete-selection-mode' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 12 Jan 2017 16:26:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 25428 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 25428@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.14842383046895 (code B ref -1); Thu, 12 Jan 2017 16:26:01 +0000 Received: (at submit) by debbugs.gnu.org; 12 Jan 2017 16:25:04 +0000 Received: from localhost ([127.0.0.1]:51729 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cRiBT-0001n9-NI for submit@debbugs.gnu.org; Thu, 12 Jan 2017 11:25:03 -0500 Received: from eggs.gnu.org ([208.118.235.92]:54177) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cRiBQ-0001ma-2P for submit@debbugs.gnu.org; Thu, 12 Jan 2017 11:25:02 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cRiBJ-0007uA-53 for submit@debbugs.gnu.org; Thu, 12 Jan 2017 11:24:55 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:52684) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1cRiBJ-0007tj-1P for submit@debbugs.gnu.org; Thu, 12 Jan 2017 11:24:53 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:45122) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cRiBH-0005bf-3Y for bug-gnu-emacs@gnu.org; Thu, 12 Jan 2017 11:24:52 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cRiBC-0007iH-4C for bug-gnu-emacs@gnu.org; Thu, 12 Jan 2017 11:24:51 -0500 Received: from userp1040.oracle.com ([156.151.31.81]:33713) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1cRiBB-0007bf-QV for bug-gnu-emacs@gnu.org; Thu, 12 Jan 2017 11:24:46 -0500 Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id v0CGOg0j008626 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 12 Jan 2017 16:24:43 GMT Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userv0022.oracle.com (8.14.4/8.14.4) with ESMTP id v0CGOfEX031778 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 12 Jan 2017 16:24:42 GMT Received: from abhmp0008.oracle.com (abhmp0008.oracle.com [141.146.116.14]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id v0CGOet4027984 for ; Thu, 12 Jan 2017 16:24:41 GMT MIME-Version: 1.0 Message-ID: Date: Thu, 12 Jan 2017 08:24:39 -0800 (PST) From: Drew Adams X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 12.0.6753.5000 (x86)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0022.oracle.com [156.151.31.74] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) The doc string says this: If called from Lisp, enable the mode if ARG is omitted or nil. That is completely wrong. This is an ordinary minor mode, defined using `define-minor-mode', whose doc string says this: When called from Lisp, the mode command toggles the mode if the argument is =E2=80=98toggle=E2=80=99, disables the mode if the argument is= a non-positive integer, and enables the mode otherwise (including if the argument is omitted or nil or a positive integer). E.g., `(delete-selection-mode t)' ENABLES the mode, even though the `delete-selection-mode' doc string says that it DISABLES it. In GNU Emacs 25.1.1 (x86_64-w64-mingw32) of 2016-09-17 built on LAPHROAIG Windowing system distributor 'Microsoft Corp.', version 6.1.7601 Configured using: 'configure --without-dbus --without-compress-install CFLAGS=3D-static' From debbugs-submit-bounces@debbugs.gnu.org Fri Jan 13 12:53:31 2017 Received: (at control) by debbugs.gnu.org; 13 Jan 2017 17:53:31 +0000 Received: from localhost ([127.0.0.1]:53130 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cS62d-0004ob-FA for submit@debbugs.gnu.org; Fri, 13 Jan 2017 12:53:31 -0500 Received: from eggs.gnu.org ([208.118.235.92]:44639) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cS62c-0004oO-DQ for control@debbugs.gnu.org; Fri, 13 Jan 2017 12:53:30 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cS62W-0006wL-Fp for control@debbugs.gnu.org; Fri, 13 Jan 2017 12:53:25 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-5.1 required=5.0 tests=BAYES_00,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:41979) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cS62W-0006w9-D1 for control@debbugs.gnu.org; Fri, 13 Jan 2017 12:53:24 -0500 Received: from rgm by fencepost.gnu.org with local (Exim 4.82) (envelope-from ) id 1cS62W-000557-37 for control@debbugs.gnu.org; Fri, 13 Jan 2017 12:53:24 -0500 Subject: control message for bug 25434 To: X-Mailer: mail (GNU Mailutils 2.99.98) Message-Id: From: Glenn Morris Date: Fri, 13 Jan 2017 12:53:24 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -8.2 (--------) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -8.2 (--------) merge 25428 25434 From unknown Sat Jun 14 19:38:39 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25428: 25.1; Incorrect doc string for `delete-selection-mode' Resent-From: nljlistbox2@gmail.com (N. Jackson) Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 17 Aug 2017 01:56:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25428 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams Cc: 25428@debbugs.gnu.org Received: via spool by 25428-submit@debbugs.gnu.org id=B25428.150293492310362 (code B ref 25428); Thu, 17 Aug 2017 01:56:02 +0000 Received: (at 25428) by debbugs.gnu.org; 17 Aug 2017 01:55:23 +0000 Received: from localhost ([127.0.0.1]:41760 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1diA1r-0002h4-0d for submit@debbugs.gnu.org; Wed, 16 Aug 2017 21:55:23 -0400 Received: from mail-it0-f65.google.com ([209.85.214.65]:36921) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1diA1p-0002gq-Bs for 25428@debbugs.gnu.org; Wed, 16 Aug 2017 21:55:21 -0400 Received: by mail-it0-f65.google.com with SMTP id 77so3461850itj.4 for <25428@debbugs.gnu.org>; Wed, 16 Aug 2017 18:55:21 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-transfer-encoding; bh=NC3VZsrWw3L59x3SnQ9EnAe9h9ODS3i4OYffGGuuho0=; b=rcJg/bFnp9SurXMzBmAse1Hhq4o2S33f8hnLA076KltFFuRGbF7cK44FpUxYvm7wuO bek9scmgz7yn0IoGXpCupYebXkpO/oIbv/MM9kmsR3K/wJEFVpvBCXoY8Lt24SDuEsVg exurBhVt5kR44fVeCxsmwlb2DleSV4mvBlpClMgrdGoyn732WaBQTgdo2Qj73D9u6DWl pB2/rnxfwP45vPTAePhqXbKrar+31RYL6kmLK6HcWYuPII9N9eE9Bo6r+nGv+sFbtn+y TGP3whhAyGRNifq6V6xAtdMfz52lKdThIVi8rzThsYRwODD67rB2VMeMHSWkY1kCQnl7 UV+w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version:content-transfer-encoding; bh=NC3VZsrWw3L59x3SnQ9EnAe9h9ODS3i4OYffGGuuho0=; b=pCCvhkGLUjsMshG6dhLOVIsIJVjzPvNAZsruIbNnN6YpZLIx82JFWBInITwD6qdcz6 xnnw8DMQ7VwK9dhoAcz9UV8oghCyR88crcXLzay4Zvza47l7/fpItwm760Ep42yldcia fx1tU8npn5KBxBn5Jq4/u9Q3uKXlfNiBIkRhtl4E/a8xjr/KHymCuVnO0Gn7cNT+bcgr 0GL6nNAg//JkX8GSIyOv6+eTbFvX4V4RwNYqHTIhgJWbqcTmKyD8C3c//mnV8ZUpQqGm m7wG4Y9rvsVDvEUsowbkM8YhPEECWGb02vO82TrrxLQjKSbldutDhqJv088Ybg1jl44S PgiQ== X-Gm-Message-State: AHYfb5gkM7BmSuagifXmbkmJHxH3t9MiGCg6AIRtpbxixZ7qaaPGB+VE Bv5xC0ebznNT1S3vl2c= X-Received: by 10.36.37.130 with SMTP id g124mr432320itg.114.1502934915567; Wed, 16 Aug 2017 18:55:15 -0700 (PDT) Received: from moondust.localdomain.nodomain.none ([184.151.179.113]) by smtp.gmail.com with ESMTPSA id 193sm989096ioo.84.2017.08.16.18.55.14 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Wed, 16 Aug 2017 18:55:15 -0700 (PDT) From: nljlistbox2@gmail.com (N. Jackson) References: Date: Wed, 16 Aug 2017 21:55:09 -0400 In-Reply-To: (Drew Adams's message of "Thu, 12 Jan 2017 08:24:39 -0800 (PST)") Message-ID: <87efsbrm9u.fsf@moondust.localdomain> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: 0.7 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.7 (/) At 07:24 -0800 on Thursday 2017-01-12, Drew Adams wrote: > The doc string says this: > > If called from Lisp, enable the mode if ARG is omitted or nil. > > That is completely wrong. This is an ordinary minor mode, > defined using `define-minor-mode', whose doc string says this: > > When called from Lisp, the mode command toggles the mode if > the argument is =E2=80=98toggle=E2=80=99, disables the mode if the argu= ment is > a non-positive integer, and enables the mode otherwise > (including if the argument is omitted or nil or a positive > integer). Hi Drew, I do not see any contradiction between these two statements. Maybe one of us is misreading them? In particular, I find that the behaviour of `delete-selection-mode' (the function) when called from Lisp matches both statements in every particular, so I don't see what you mean by "completely wrong". > E.g., `(delete-selection-mode t)' ENABLES the mode, even though the > `delete-selection-mode' doc string says that it DISABLES it. Yes, this enables the mode, but no, the doc string does *not* say this disables it. (In fact, it is silent on how to disable it from Lisp.) Am I missing something? Admittedly, the part of its doc string that says how to use the `delete-selection-mode' function from Lisp seems inadequate: It doesn't say how to toggle the mode, it doesn't say how to disable the mode, and the methods it mentions for enabling the mode do not include the most straightforward one (passing it `t'). [Temporary minor rant: Personally it seems absurd to me that a `nil' argument doesn't turn a minor mode off; and that calling the minor mode function with no argument doesn't toggle it. But that is all history of course.] Anyway, does it make sense to re-document the canonical behaviour of minor mode commands in the doc string of every minor mode command? Maybe it would be better (as I think you might have suggested in another bug report back in January) if the doc string of the each minor mode command had a link to the documentation of the canonical behaviour. N. From unknown Sat Jun 14 19:38:39 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25428: 25.1; Incorrect doc string for `delete-selection-mode' Resent-From: npostavs@users.sourceforge.net Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 17 Aug 2017 02:23:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25428 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: nljlistbox2@gmail.com (N. Jackson) Cc: 25428@debbugs.gnu.org, Drew Adams Received: via spool by 25428-submit@debbugs.gnu.org id=B25428.150293656612795 (code B ref 25428); Thu, 17 Aug 2017 02:23:01 +0000 Received: (at 25428) by debbugs.gnu.org; 17 Aug 2017 02:22:46 +0000 Received: from localhost ([127.0.0.1]:41769 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1diASM-0003KI-9N for submit@debbugs.gnu.org; Wed, 16 Aug 2017 22:22:46 -0400 Received: from mail-io0-f193.google.com ([209.85.223.193]:37817) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1diASK-0003K1-Nu for 25428@debbugs.gnu.org; Wed, 16 Aug 2017 22:22:44 -0400 Received: by mail-io0-f193.google.com with SMTP id c74so3317923iod.4 for <25428@debbugs.gnu.org>; Wed, 16 Aug 2017 19:22:44 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=jqRubkmg/cdGyvmYDi78q84v3Kt4qrfp3xoIuVUhlGw=; b=ChX5jlVsz0rxhJRs1hpJcVIQ5Z95IjbIxKNYDdFq89XtnFcJI/0iy4rqx06lZYk/bG u2VpuFDyqjS6xkhXpWwCq2sC/6s4ANV5RhA/bOV03jSFY+jh19nIhq6y3qnOYXek7kae v2uMsnXSC8zqiJf7cj38IgEh1+UtJahYs+eDiodxx+Wbvm8/VOBWTZ5KSdyxmNlNwPpP 9IVBW8UOemZ7ev9llbPJU4yos7srFWpZ9nAGEm0O5dTVf8zZlnp4WsRBU5bdQs9slxX3 CClguPZtkJVoVnj9dGJxta1CV1AhJGnDTjVfWy00IpZYWu/vUVPzStT+1EOZpj6BFv0G 8oXA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:references:date :in-reply-to:message-id:user-agent:mime-version; bh=jqRubkmg/cdGyvmYDi78q84v3Kt4qrfp3xoIuVUhlGw=; b=CYkx+NZ0w4K1VETvHSEaDvNi0FrFy5hYQGSf3jSgtDJJXpCU3/H+nt6zP0cx6lxNS1 +jTdEeXDM7+SnbH+avxju6VjKPLfYNsmBxlzRDE4ufJihKYp0FAC0pBVdPxejq/wL0hh jeMtjiBjEuLLkO1lT3HNZwJ6AoBRdcdiJNlrbr8sPjnYiVEfY4x3WxPnWQb02IM/9jsg 3wyHXUrlIEv2noGKgZI54q+yWTJicWwS+IosPjx9vjfTF8Y/zL2iDQU98o2n5pcJBHIp +3hFN1SZHd+dzzsABXAoa8PezcrvfQyOG3vPG9C2/gUC9kZUq6xHYQPaVlngpTzDbQmP FGhA== X-Gm-Message-State: AHYfb5h/7ZX4VMY2rZrWXCckOQTlF8RW/ND4r0QQSGXDjCq7pD9wvJB7 sb59hsxBjKyIx8Ea X-Received: by 10.107.132.233 with SMTP id o102mr3788902ioi.214.1502936559062; Wed, 16 Aug 2017 19:22:39 -0700 (PDT) Received: from zony ([45.2.119.49]) by smtp.googlemail.com with ESMTPSA id m44sm249430iti.0.2017.08.16.19.22.37 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Wed, 16 Aug 2017 19:22:37 -0700 (PDT) From: npostavs@users.sourceforge.net References: <87efsbrm9u.fsf@moondust.localdomain> Date: Wed, 16 Aug 2017 22:24:15 -0400 In-Reply-To: <87efsbrm9u.fsf@moondust.localdomain> (N. Jackson's message of "Wed, 16 Aug 2017 21:55:09 -0400") Message-ID: <874lt7ylrk.fsf@users.sourceforge.net> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.2.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.1 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.1 (--) nljlistbox2@gmail.com (N. Jackson) writes: > [Temporary minor rant: Personally it seems absurd to me that a > `nil' argument doesn't turn a minor mode off; and that calling the > minor mode function with no argument doesn't toggle it. But that > is all history of course.] There is a good reason to have it like that: it allows doing (add-hook 'some-hook #'the-minor-mode) Rather than having to do (add-hook 'some-hook (lambda () (the-minor-mode +1))) or (defun turn-on-the-minor-mode () (the-minor-mode +1)) (add-hook 'some-hook #'turn-on-the-minor-mode) From unknown Sat Jun 14 19:38:39 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25428: 25.1; Incorrect doc string for `delete-selection-mode' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 17 Aug 2017 03:27:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25428 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: nljlistbox2@gmail.com Cc: 25428@debbugs.gnu.org Received: via spool by 25428-submit@debbugs.gnu.org id=B25428.150294037318593 (code B ref 25428); Thu, 17 Aug 2017 03:27:01 +0000 Received: (at 25428) by debbugs.gnu.org; 17 Aug 2017 03:26:13 +0000 Received: from localhost ([127.0.0.1]:41790 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1diBRl-0004pp-98 for submit@debbugs.gnu.org; Wed, 16 Aug 2017 23:26:13 -0400 Received: from userp1040.oracle.com ([156.151.31.81]:27589) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1diBRj-0004pb-Ja for 25428@debbugs.gnu.org; Wed, 16 Aug 2017 23:26:12 -0400 Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id v7H3Q452003740 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 17 Aug 2017 03:26:05 GMT Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by userv0021.oracle.com (8.14.4/8.14.4) with ESMTP id v7H3Q4xo008777 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 17 Aug 2017 03:26:04 GMT Received: from abhmp0006.oracle.com (abhmp0006.oracle.com [141.146.116.12]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id v7H3Q3kr020804; Thu, 17 Aug 2017 03:26:04 GMT MIME-Version: 1.0 Message-ID: <2e0430c1-4783-4b53-ac95-300282a1a6be@default> Date: Wed, 16 Aug 2017 20:25:31 -0700 (PDT) From: Drew Adams References: <87efsbrm9u.fsf@moondust.localdomain> In-Reply-To: <87efsbrm9u.fsf@moondust.localdomain> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 12.0.6774.5000 (x86)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0021.oracle.com [156.151.31.71] X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) Let's just say that the doc string is incomplete and can easily mislead. If it says anything about interactive behavior (and it should) then it should say just what the description of `define-minor-mode' says for minor modes. If it says anything about the behavior when called from Lisp (and it should) then it should say just what the d-m-m description says. This (i.e., _all_ of the d-m-m description) is missing from the d-s-m doc string: * `toggle' toggles * non-positive integer disables * anything else enables The only bit of info you get about Lisp behavior is that nil/absent enables - part of the "anything else". Yes, the doc string does not say that (d-s-m t) disables. But a cursory reading of this: "If called from Lisp, enable the mode if ARG is omitted or nil." can give that impression. Sure, it says "if" and not "only if", but we all know that may people will understand "only if" or "if and only if". [And you can see that explicitly in the thread of bug #25435: after reading such a description the filer thought it implied that passing `off' should turn it off. To which the snarky reply was to belittle the filer's sense telling him: "Surely common sense tells you that is the intended meaning? There are about 130 instances of this form in Emacs. There are 4 instances of ", also enable", maybe you prefer that? Feel feel to correct them all, I guess, if it bothers you that much. :)"] And as I said in the thread for bug #13926: "This makes no connection between the interactive prefix arg and the arg when called from Lisp. In particular, it can also give the incorrect impression that the mode is enabled ONLY if ARG is omitted or nil. There is nothing that suggests the behavior of a non-positive or positive ARG when called from Lisp." It is also misleading for the doc string to talk about ARG as if it were the prefix arg. Right away that is going to feed confusion: absence of a prefix arg toggles, but in Lisp absence of ARG enables. Rather than the doc making clear the difference between prefix arg interactively and ARG from Lisp, it seems to go out of its way to confuse the two, saying "With a prefix ARG" instead of "With a prefix arg" (or better, "prefix argument"). Better still would be to name the parameter something else than ARG, to avoid just such confusion. The behavior of minor-mode arguments is complex enough, without bad doc to confuse things further. It really should be clear by now that clearer doc is needed about the behavior of minor-mode arguments (and there continue to be questions and confusions about on reddit, stackexchange, etc.). How hard is it get this right now, especially when writing new doc strings? The point is that there is no reason to say anything different for this than what is true for all minor modes and what is said in the doc for d-m-m. No, a user of a minor-mode function should not need to read the doc of d-m-m to obtain info about its behavior. Yes, each command should have a doc string that describes its behavior: (1) interactively and (2) via Lisp. (And if a command is not intended for use from Lisp then that should be stated explicitly.) Do I think that it would be sufficient for every command defined with d-m-m to have a link to the doc string of d-m-m? It would be OK, I think. But barring that, each minor-mode doc string needs to stand on its own and provide that same info - not something partial or misleading. From unknown Sat Jun 14 19:38:39 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Drew Adams Subject: bug#25428: closed (Re: bug#25428: 25.1; Incorrect doc string for `delete-selection-mode') Message-ID: References: <83tw0u66qv.fsf@gnu.org> X-Gnu-PR-Message: they-closed 25428 X-Gnu-PR-Package: emacs Reply-To: 25428@debbugs.gnu.org Date: Sat, 26 Aug 2017 09:04:04 +0000 Content-Type: multipart/mixed; boundary="----------=_1503738244-1817-1" This is a multi-part message in MIME format... ------------=_1503738244-1817-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #25428: 25.1; Incorrect doc string for `delete-selection-mode' which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 25428@debbugs.gnu.org. --=20 25428: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D25428 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1503738244-1817-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 25428-done) by debbugs.gnu.org; 26 Aug 2017 09:03:40 +0000 Received: from localhost ([127.0.0.1]:55938 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dlX0G-0000Sl-Ee for submit@debbugs.gnu.org; Sat, 26 Aug 2017 05:03:40 -0400 Received: from eggs.gnu.org ([208.118.235.92]:32955) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dlX0E-0000SY-L0 for 25428-done@debbugs.gnu.org; Sat, 26 Aug 2017 05:03:39 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dlX06-0001Qn-R4 for 25428-done@debbugs.gnu.org; Sat, 26 Aug 2017 05:03:33 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:59437) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dlX06-0001Qh-NV; Sat, 26 Aug 2017 05:03:30 -0400 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4484 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1dlX05-0005XD-NB; Sat, 26 Aug 2017 05:03:30 -0400 Date: Sat, 26 Aug 2017 12:03:20 +0300 Message-Id: <83tw0u66qv.fsf@gnu.org> From: Eli Zaretskii To: Drew Adams In-reply-to: <2e0430c1-4783-4b53-ac95-300282a1a6be@default> (message from Drew Adams on Wed, 16 Aug 2017 20:25:31 -0700 (PDT)) Subject: Re: bug#25428: 25.1; Incorrect doc string for `delete-selection-mode' References: <87efsbrm9u.fsf@moondust.localdomain> <2e0430c1-4783-4b53-ac95-300282a1a6be@default> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: 25428-done Cc: 25428-done@debbugs.gnu.org, nljlistbox2@gmail.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) > Date: Wed, 16 Aug 2017 20:25:31 -0700 (PDT) > From: Drew Adams > Cc: 25428@debbugs.gnu.org > > Let's just say that the doc string is incomplete and can easily > mislead. > > If it says anything about interactive behavior (and it should) > then it should say just what the description of `define-minor-mode' > says for minor modes. > > If it says anything about the behavior when called from > Lisp (and it should) then it should say just what the d-m-m > description says. This (i.e., _all_ of the d-m-m description) > is missing from the d-s-m doc string: > > * `toggle' toggles > * non-positive integer disables > * anything else enables Thanks, I fixed the doc string to include the missing information. ------------=_1503738244-1817-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 12 Jan 2017 16:25:04 +0000 Received: from localhost ([127.0.0.1]:51729 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cRiBT-0001n9-NI for submit@debbugs.gnu.org; Thu, 12 Jan 2017 11:25:03 -0500 Received: from eggs.gnu.org ([208.118.235.92]:54177) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cRiBQ-0001ma-2P for submit@debbugs.gnu.org; Thu, 12 Jan 2017 11:25:02 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cRiBJ-0007uA-53 for submit@debbugs.gnu.org; Thu, 12 Jan 2017 11:24:55 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:52684) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1cRiBJ-0007tj-1P for submit@debbugs.gnu.org; Thu, 12 Jan 2017 11:24:53 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:45122) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cRiBH-0005bf-3Y for bug-gnu-emacs@gnu.org; Thu, 12 Jan 2017 11:24:52 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cRiBC-0007iH-4C for bug-gnu-emacs@gnu.org; Thu, 12 Jan 2017 11:24:51 -0500 Received: from userp1040.oracle.com ([156.151.31.81]:33713) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1cRiBB-0007bf-QV for bug-gnu-emacs@gnu.org; Thu, 12 Jan 2017 11:24:46 -0500 Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id v0CGOg0j008626 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 12 Jan 2017 16:24:43 GMT Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userv0022.oracle.com (8.14.4/8.14.4) with ESMTP id v0CGOfEX031778 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 12 Jan 2017 16:24:42 GMT Received: from abhmp0008.oracle.com (abhmp0008.oracle.com [141.146.116.14]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id v0CGOet4027984 for ; Thu, 12 Jan 2017 16:24:41 GMT MIME-Version: 1.0 Message-ID: Date: Thu, 12 Jan 2017 08:24:39 -0800 (PST) From: Drew Adams To: bug-gnu-emacs@gnu.org Subject: 25.1; Incorrect doc string for `delete-selection-mode' X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 12.0.6753.5000 (x86)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0022.oracle.com [156.151.31.74] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) The doc string says this: If called from Lisp, enable the mode if ARG is omitted or nil. That is completely wrong. This is an ordinary minor mode, defined using `define-minor-mode', whose doc string says this: When called from Lisp, the mode command toggles the mode if the argument is =E2=80=98toggle=E2=80=99, disables the mode if the argument is= a non-positive integer, and enables the mode otherwise (including if the argument is omitted or nil or a positive integer). E.g., `(delete-selection-mode t)' ENABLES the mode, even though the `delete-selection-mode' doc string says that it DISABLES it. In GNU Emacs 25.1.1 (x86_64-w64-mingw32) of 2016-09-17 built on LAPHROAIG Windowing system distributor 'Microsoft Corp.', version 6.1.7601 Configured using: 'configure --without-dbus --without-compress-install CFLAGS=3D-static' ------------=_1503738244-1817-1-- From unknown Sat Jun 14 19:38:39 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: "Drew Adams" Subject: bug#13926: closed (Re: bug#25428: 25.1; Incorrect doc string for `delete-selection-mode') Message-ID: References: <83tw0u66qv.fsf@gnu.org> <25665444134D45E08D468EC49539ACEA@us.oracle.com> X-Gnu-PR-Message: they-closed 13926 X-Gnu-PR-Package: emacs Reply-To: 13926@debbugs.gnu.org Date: Sat, 26 Aug 2017 09:04:04 +0000 Content-Type: multipart/mixed; boundary="----------=_1503738244-1817-3" This is a multi-part message in MIME format... ------------=_1503738244-1817-3 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #25428: 24.3.50; doc string of `visual-line-mode' which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 13926@debbugs.gnu.org. --=20 25428: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D25428 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1503738244-1817-3 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 25428-done) by debbugs.gnu.org; 26 Aug 2017 09:03:40 +0000 Received: from localhost ([127.0.0.1]:55938 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dlX0G-0000Sl-Ee for submit@debbugs.gnu.org; Sat, 26 Aug 2017 05:03:40 -0400 Received: from eggs.gnu.org ([208.118.235.92]:32955) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dlX0E-0000SY-L0 for 25428-done@debbugs.gnu.org; Sat, 26 Aug 2017 05:03:39 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dlX06-0001Qn-R4 for 25428-done@debbugs.gnu.org; Sat, 26 Aug 2017 05:03:33 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:59437) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dlX06-0001Qh-NV; Sat, 26 Aug 2017 05:03:30 -0400 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4484 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1dlX05-0005XD-NB; Sat, 26 Aug 2017 05:03:30 -0400 Date: Sat, 26 Aug 2017 12:03:20 +0300 Message-Id: <83tw0u66qv.fsf@gnu.org> From: Eli Zaretskii To: Drew Adams In-reply-to: <2e0430c1-4783-4b53-ac95-300282a1a6be@default> (message from Drew Adams on Wed, 16 Aug 2017 20:25:31 -0700 (PDT)) Subject: Re: bug#25428: 25.1; Incorrect doc string for `delete-selection-mode' References: <87efsbrm9u.fsf@moondust.localdomain> <2e0430c1-4783-4b53-ac95-300282a1a6be@default> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: 25428-done Cc: 25428-done@debbugs.gnu.org, nljlistbox2@gmail.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) > Date: Wed, 16 Aug 2017 20:25:31 -0700 (PDT) > From: Drew Adams > Cc: 25428@debbugs.gnu.org > > Let's just say that the doc string is incomplete and can easily > mislead. > > If it says anything about interactive behavior (and it should) > then it should say just what the description of `define-minor-mode' > says for minor modes. > > If it says anything about the behavior when called from > Lisp (and it should) then it should say just what the d-m-m > description says. This (i.e., _all_ of the d-m-m description) > is missing from the d-s-m doc string: > > * `toggle' toggles > * non-positive integer disables > * anything else enables Thanks, I fixed the doc string to include the missing information. ------------=_1503738244-1817-3 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 11 Mar 2013 20:20:47 +0000 Received: from localhost ([127.0.0.1]:46836 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1UF9DC-0008TK-Pl for submit@debbugs.gnu.org; Mon, 11 Mar 2013 16:20:47 -0400 Received: from eggs.gnu.org ([208.118.235.92]:55383) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1UF9DA-0008T8-BT for submit@debbugs.gnu.org; Mon, 11 Mar 2013 16:20:45 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UF9C9-0003f3-4b for submit@debbugs.gnu.org; Mon, 11 Mar 2013 16:19:43 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-106.6 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_MED, RP_MATCHES_RCVD, UNPARSEABLE_RELAY, USER_IN_WHITELIST autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:41778) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UF9C9-0003ez-1R for submit@debbugs.gnu.org; Mon, 11 Mar 2013 16:19:41 -0400 Received: from eggs.gnu.org ([208.118.235.92]:38474) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UF9C6-00059l-AW for bug-gnu-emacs@gnu.org; Mon, 11 Mar 2013 16:19:40 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UF9C2-0003dI-Jq for bug-gnu-emacs@gnu.org; Mon, 11 Mar 2013 16:19:38 -0400 Received: from userp1040.oracle.com ([156.151.31.81]:28117) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UF9C2-0003d7-Bk for bug-gnu-emacs@gnu.org; Mon, 11 Mar 2013 16:19:34 -0400 Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by userp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with ESMTP id r2BKJXaO002438 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Mon, 11 Mar 2013 20:19:33 GMT Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r2BKJWg3011745 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Mon, 11 Mar 2013 20:19:32 GMT Received: from abhmt115.oracle.com (abhmt115.oracle.com [141.146.116.67]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id r2BKJVOM000358 for ; Mon, 11 Mar 2013 15:19:32 -0500 Received: from dradamslap1 (/130.35.178.8) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Mon, 11 Mar 2013 13:19:31 -0700 From: "Drew Adams" To: Subject: 24.3.50; doc string of `visual-line-mode' Date: Mon, 11 Mar 2013 13:19:30 -0700 Message-ID: <25665444134D45E08D468EC49539ACEA@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: Ac4elbzSXp0yqPiQQLK1co3dOBgK7g== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 208.118.235.17 X-Spam-Score: -4.3 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.2 (------) The doc string is misleading wrt the argument when called from Lisp. With a prefix argument ARG, enable Visual Line mode if ARG is positive, and disable it otherwise. If called from Lisp, enable the mode if ARG is omitted or nil. This makes no connection between the interactive prefix arg and the arg when called from Lisp. In particular, it can also give the incorrect impression that the mode is enabled ONLY if ARG is omitted or nil. There is nothing that suggests the behavior of a non-positive or positive ARG when called from Lisp. By way of contrast, the doc string of `define-minor-mode' correctly says what the argument values do when called from Lisp: When called from Lisp, the mode command toggles the mode if the argument is `toggle', disables the mode if the argument is a non-positive integer, and enables the mode otherwise (including if the argument is omitted or nil or a positive integer). This kind of careful description should probably be added automatically to functions defined by `define-minor-mode', to prevent misleading doc wrt the argument. In GNU Emacs 24.3.50.1 (i386-mingw-nt5.1.2600) of 2013-03-04 on ODIEONE Bzr revision: 111935 yamaoka@jpl.org-20130304102733-4qy111z41qwoh2as Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.7) --no-opt --enable-checking --cflags -IC:/Devel/emacs/build/include --ldflags -LC:/Devel/emacs/build/lib' ------------=_1503738244-1817-3-- From unknown Sat Jun 14 19:38:39 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Francesco =?UTF-8?Q?Potort=C3=AC?= Subject: bug#25434: closed (Re: bug#25428: 25.1; Incorrect doc string for `delete-selection-mode') Message-ID: References: <83tw0u66qv.fsf@gnu.org> X-Gnu-PR-Message: they-closed 25434 X-Gnu-PR-Package: emacs Reply-To: 25434@debbugs.gnu.org Date: Sat, 26 Aug 2017 09:04:05 +0000 Content-Type: multipart/mixed; boundary="----------=_1503738245-1817-5" This is a multi-part message in MIME format... ------------=_1503738245-1817-5 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #25428: 25.1; visual-line-mode is enabled with arg 1 which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 25434@debbugs.gnu.org. --=20 25428: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D25428 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1503738245-1817-5 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 25428-done) by debbugs.gnu.org; 26 Aug 2017 09:03:40 +0000 Received: from localhost ([127.0.0.1]:55938 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dlX0G-0000Sl-Ee for submit@debbugs.gnu.org; Sat, 26 Aug 2017 05:03:40 -0400 Received: from eggs.gnu.org ([208.118.235.92]:32955) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dlX0E-0000SY-L0 for 25428-done@debbugs.gnu.org; Sat, 26 Aug 2017 05:03:39 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dlX06-0001Qn-R4 for 25428-done@debbugs.gnu.org; Sat, 26 Aug 2017 05:03:33 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:59437) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dlX06-0001Qh-NV; Sat, 26 Aug 2017 05:03:30 -0400 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4484 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1dlX05-0005XD-NB; Sat, 26 Aug 2017 05:03:30 -0400 Date: Sat, 26 Aug 2017 12:03:20 +0300 Message-Id: <83tw0u66qv.fsf@gnu.org> From: Eli Zaretskii To: Drew Adams In-reply-to: <2e0430c1-4783-4b53-ac95-300282a1a6be@default> (message from Drew Adams on Wed, 16 Aug 2017 20:25:31 -0700 (PDT)) Subject: Re: bug#25428: 25.1; Incorrect doc string for `delete-selection-mode' References: <87efsbrm9u.fsf@moondust.localdomain> <2e0430c1-4783-4b53-ac95-300282a1a6be@default> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: 25428-done Cc: 25428-done@debbugs.gnu.org, nljlistbox2@gmail.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) > Date: Wed, 16 Aug 2017 20:25:31 -0700 (PDT) > From: Drew Adams > Cc: 25428@debbugs.gnu.org > > Let's just say that the doc string is incomplete and can easily > mislead. > > If it says anything about interactive behavior (and it should) > then it should say just what the description of `define-minor-mode' > says for minor modes. > > If it says anything about the behavior when called from > Lisp (and it should) then it should say just what the d-m-m > description says. This (i.e., _all_ of the d-m-m description) > is missing from the d-s-m doc string: > > * `toggle' toggles > * non-positive integer disables > * anything else enables Thanks, I fixed the doc string to include the missing information. ------------=_1503738245-1817-5 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 13 Jan 2017 11:07:48 +0000 Received: from localhost ([127.0.0.1]:52114 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cRzhz-0006em-VO for submit@debbugs.gnu.org; Fri, 13 Jan 2017 06:07:48 -0500 Received: from eggs.gnu.org ([208.118.235.92]:54129) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cRzhx-0006eY-JP for submit@debbugs.gnu.org; Fri, 13 Jan 2017 06:07:46 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cRzhq-0003Gz-Q0 for submit@debbugs.gnu.org; Fri, 13 Jan 2017 06:07:40 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-2.4 required=5.0 tests=BAYES_50,RP_MATCHES_RCVD, T_MANY_HDRS_LCASE autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:48573) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1cRzhq-0003Gc-Mt for submit@debbugs.gnu.org; Fri, 13 Jan 2017 06:07:38 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:45092) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cRzho-0004Vu-MC for bug-gnu-emacs@gnu.org; Fri, 13 Jan 2017 06:07:38 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cRzhi-0003BY-Gc for bug-gnu-emacs@gnu.org; Fri, 13 Jan 2017 06:07:36 -0500 Received: from blade3.isti.cnr.it ([194.119.192.19]:31689) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1cRzhi-00039N-4n for bug-gnu-emacs@gnu.org; Fri, 13 Jan 2017 06:07:30 -0500 Received: from tucano.isti.cnr.it ([146.48.81.102]) by mx.isti.cnr.it (PMDF V6.5-x6 #1251) with ESMTPSA id <01Q9MVHVE88KDBHLWK@mx.isti.cnr.it> for bug-gnu-emacs@gnu.org; Fri, 13 Jan 2017 12:07:26 +0100 (MET) Received: from pot by tucano.isti.cnr.it with local (Exim 4.88) (envelope-from ) id 1cRzhd-0002ah-Dj for bug-gnu-emacs@gnu.org; Fri, 13 Jan 2017 12:07:25 +0100 Date: Fri, 13 Jan 2017 12:07:25 +0100 From: =?utf-8?Q?Francesco_Potort=C3=AC?= Subject: 25.1; visual-line-mode is enabled with arg 1 To: bug-gnu-emacs@gnu.org Message-id: Organization: MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-transfer-encoding: 8bit X-INSM-ip-source: 146.48.81.102 Auth Done X-fingerprint: 4B02 6187 5C03 D6B1 2E31 7666 09DF 2DC9 BE21 6115 X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -8.2 (--------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -8.2 (--------) Contrary to the docs, visual-line-mode is eanbled with arg 1 and disabled with arg 0. In GNU Emacs 25.1.1 (x86_64-pc-linux-gnu, X toolkit, Xaw3d scroll bars) of 2016-10-24, modified by Debian built on trouble Windowing system distributor 'The X.Org Foundation', version 11.0.11900000 System Description: Debian GNU/Linux testing (stretch) Configured using: 'configure --build x86_64-linux-gnu --prefix=/usr --sharedstatedir=/var/lib --libexecdir=/usr/lib --localstatedir=/var/lib --infodir=/usr/share/info --mandir=/usr/share/man --with-pop=yes --enable-locallisppath=/etc/emacs25:/etc/emacs:/usr/local/share/emacs/25.1/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/25.1/site-lisp:/usr/share/emacs/site-lisp --with-sound=alsa --build x86_64-linux-gnu --prefix=/usr --sharedstatedir=/var/lib --libexecdir=/usr/lib --localstatedir=/var/lib --infodir=/usr/share/info --mandir=/usr/share/man --with-pop=yes --enable-locallisppath=/etc/emacs25:/etc/emacs:/usr/local/share/emacs/25.1/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/25.1/site-lisp:/usr/share/emacs/site-lisp --with-sound=alsa --with-x=yes --with-x-toolkit=lucid --with-toolkit-scroll-bars --without-gconf --without-gsettings 'CFLAGS=-g -O2 -fdebug-prefix-map=/build/emacs25-25.1+1=. -fstack-protector-strong -Wformat -Werror=format-security -Wall' 'CPPFLAGS=-Wdate-time -D_FORTIFY_SOURCE=2' LDFLAGS=-Wl,-z,relro' Configured features: XAW3D XPM JPEG TIFF GIF PNG RSVG IMAGEMAGICK SOUND GPM DBUS NOTIFY ACL LIBSELINUX GNUTLS LIBXML2 FREETYPE M17N_FLT LIBOTF XFT ZLIB TOOLKIT_SCROLL_BARS LUCID X11 Important settings: value of $LC_COLLATE: it_IT.UTF-8 value of $LC_CTYPE: it_IT.UTF-8 value of $LC_NUMERIC: C value of $LANG: en_US.UTF-8 locale-coding-system: utf-8-unix Major mode: Emacs-Lisp Minor modes in effect: visual-fill-column-mode: t diff-auto-refine-mode: t TeX-PDF-mode: t desktop-save-mode: t epa-global-mail-mode: t shell-dirtrack-mode: t openwith-mode: t xterm-mouse-mode: t display-time-mode: t tooltip-mode: t global-eldoc-mode: t electric-indent-mode: t mouse-wheel-mode: t tool-bar-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t column-number-mode: t line-number-mode: t auto-fill-function: do-auto-fill Recent messages: Ruler mode enabled in current buffer Ruler mode disabled in current buffer Ruler mode enabled in current buffer Ruler mode disabled in current buffer Type C-x 1 to delete the help window. Mark set Auto-saving...done Mark set Type C-x 1 to delete the help window. C-h C-g is undefined Load-path shadows: ~/elisp/bhl hides /usr/share/emacs/site-lisp/bhl /usr/share/emacs25/site-lisp/flim/md4 hides /usr/share/emacs/25.1/lisp/md4 /usr/share/emacs25/site-lisp/flim/hex-util hides /usr/share/emacs/25.1/lisp/hex-util /usr/share/emacs/site-lisp/rst hides /usr/share/emacs/25.1/lisp/textmodes/rst ~/elisp/bibtex hides /usr/share/emacs/25.1/lisp/textmodes/bibtex /usr/share/emacs25/site-lisp/flim/ntlm hides /usr/share/emacs/25.1/lisp/net/ntlm /usr/share/emacs25/site-lisp/flim/hmac-md5 hides /usr/share/emacs/25.1/lisp/net/hmac-md5 /usr/share/emacs25/site-lisp/flim/sasl-ntlm hides /usr/share/emacs/25.1/lisp/net/sasl-ntlm /usr/share/emacs25/site-lisp/flim/sasl-digest hides /usr/share/emacs/25.1/lisp/net/sasl-digest /usr/share/emacs25/site-lisp/flim/sasl hides /usr/share/emacs/25.1/lisp/net/sasl /usr/share/emacs25/site-lisp/flim/sasl-cram hides /usr/share/emacs/25.1/lisp/net/sasl-cram /usr/share/emacs25/site-lisp/flim/hmac-def hides /usr/share/emacs/25.1/lisp/net/hmac-def /usr/share/emacs25/site-lisp/auctex/tex-fold hides /usr/share/emacs/site-lisp/auctex/tex-fold /usr/share/emacs25/site-lisp/auctex/context-en hides /usr/share/emacs/site-lisp/auctex/context-en /usr/share/emacs25/site-lisp/auctex/tex-info hides /usr/share/emacs/site-lisp/auctex/tex-info /usr/share/emacs25/site-lisp/auctex/plain-tex hides /usr/share/emacs/site-lisp/auctex/plain-tex /usr/share/emacs25/site-lisp/auctex/tex-mik hides /usr/share/emacs/site-lisp/auctex/tex-mik /usr/share/emacs25/site-lisp/auctex/texmathp hides /usr/share/emacs/site-lisp/auctex/texmathp /usr/share/emacs25/site-lisp/auctex/context-nl hides /usr/share/emacs/site-lisp/auctex/context-nl /usr/share/emacs25/site-lisp/auctex/toolbar-x hides /usr/share/emacs/site-lisp/auctex/toolbar-x /usr/share/emacs25/site-lisp/auctex/tex hides /usr/share/emacs/site-lisp/auctex/tex /usr/share/emacs25/site-lisp/auctex/tex-jp hides /usr/share/emacs/site-lisp/auctex/tex-jp /usr/share/emacs25/site-lisp/auctex/bib-cite hides /usr/share/emacs/site-lisp/auctex/bib-cite /usr/share/emacs25/site-lisp/auctex/multi-prompt hides /usr/share/emacs/site-lisp/auctex/multi-prompt /usr/share/emacs25/site-lisp/auctex/font-latex hides /usr/share/emacs/site-lisp/auctex/font-latex /usr/share/emacs25/site-lisp/auctex/prv-emacs hides /usr/share/emacs/site-lisp/auctex/prv-emacs /usr/share/emacs25/site-lisp/auctex/tex-style hides /usr/share/emacs/site-lisp/auctex/tex-style /usr/share/emacs25/site-lisp/auctex/context hides /usr/share/emacs/site-lisp/auctex/context /usr/share/emacs25/site-lisp/auctex/preview hides /usr/share/emacs/site-lisp/auctex/preview /usr/share/emacs25/site-lisp/auctex/tex-font hides /usr/share/emacs/site-lisp/auctex/tex-font /usr/share/emacs25/site-lisp/auctex/tex-bar hides /usr/share/emacs/site-lisp/auctex/tex-bar /usr/share/emacs25/site-lisp/auctex/latex hides /usr/share/emacs/site-lisp/auctex/latex /usr/share/emacs25/site-lisp/auctex/tex-buf hides /usr/share/emacs/site-lisp/auctex/tex-buf ~/elisp/bhl hides /usr/share/emacs25/site-lisp/bhl /usr/share/emacs/site-lisp/debian-startup hides /usr/share/emacs25/site-lisp/debian-startup Features: (ruler-mode cal-x debug two-column iso-transl apropos pcmpl-gnu pcmpl-linux macros python tramp-sh tar-mode anything-config anything woman mailcap undigest cal-move smerge-mode diff doc-view vc-cvs pcmpl-unix json-mode rx cus-edit wid-edit cus-start cus-load rmailedit tabify man vc-dir ewoc tramp-cache shadow emacsbug reporter debian-bug mail-extr texmathp nxml-uchnm rng-xsd xsd-regexp rng-cmpct rng-nxml rng-valid rng-loc rng-uri rng-parse nxml-parse rng-match rng-dt rng-util rng-pttrn nxml-ns nxml-mode nxml-outln nxml-rap nxml-util nxml-glyph nxml-enc xmltok tmm ido etags xref project ediff-merg ediff-wind ediff-diff ediff-mult ediff-help ediff-init ediff-util ediff js json map imenu ispell log-view pp visual-fill-column locate dired-aux eieio-opt speedbar sb-image ezimage dframe find-func timezone rmailsort face-remap url-handlers nero cl rect log-edit pcvs-util add-log grep dabbrev diff-mode vc rmailkwd mailalias rmailout shr-color color time-stamp misearch multi-isearch server parse-time unrmail qp url-util shr dom subr-x browse-url jka-compr cc-mode cc-fonts cc-guess cc-menus cc-cmds cc-styles cc-align cc-engine cc-vars cc-defs bibtex info sh-script executable sgml-mode vc-filewise vc-rcs image-mode view conf-mode generic octave smie latexenc plain-tex vc-dispatcher vc-svn preview prv-emacs tex-bar tex-buf toolbar-x noutline outline font-latex latex easy-mmode edmacro kmacro tex-style tex dbus xml crm tex-mode compile rmailmm message rfc822 mml mml-sec mm-decode mm-bodies mm-encode mailabbrev gmm-utils mailheader mail-parse rfc2231 desktop frameset term/xterm xterm pot skeleton rmailsum rmail warnings sendmail rfc2047 rfc2045 ietf-drums mime-compose epa-mail mail-utils epa derived epg cal-china lunar solar cal-dst cal-bahai cal-islam cal-hebrew holidays hol-loaddefs vc-hg appt diary-lib diary-loaddefs cal-menu calendar cal-loaddefs tramp tramp-compat tramp-loaddefs trampver ucs-normalize shell pcomplete comint ring format-spec bhl switch-to-shell openwith hi-lock xt-mouse ffap thingatpt url-parse auth-source cl-seq eieio eieio-core cl-macs gnus-util time-date mm-util help-fns mail-prsvr password-cache url-vars scroll-in-place filladapt ansi-color advice time quail dired-x dired generic-x disp-table finder-inf package epg-config seq byte-opt gv bytecomp byte-compile cl-extra help-mode easymenu cconv cl-loaddefs pcase cl-lib debian-el debian-el-loaddefs w3m-load vm-autoload vm-autoloads vm-version vm-vars vm-init preview-latex tex-site auto-loads mule-util tooltip eldoc electric uniquify ediff-hook vc-hooks lisp-float-type mwheel x-win term/common-win x-dnd tool-bar dnd fontset image regexp-opt fringe tabulated-list newcomment elisp-mode lisp-mode prog-mode register page menu-bar rfn-eshadow timer select scroll-bar mouse jit-lock font-lock syntax facemenu font-core frame cl-generic cham georgian utf-8-lang misc-lang vietnamese tibetan thai tai-viet lao korean japanese eucjp-ms cp51932 hebrew greek romanian slovak czech european ethiopic indian cyrillic chinese charscript case-table epa-hook jka-cmpr-hook help simple abbrev minibuffer cl-preloaded nadvice loaddefs button faces cus-face macroexp files text-properties overlay sha1 md5 base64 format env code-pages mule custom widget hashtable-print-readable backquote dbusbind inotify dynamic-setting font-render-setting x-toolkit x multi-tty make-network-process emacs) Memory information: ((conses 16 1177856 153879) (symbols 48 60417 0) (miscs 40 8624 6950) (strings 32 175127 30372) (string-bytes 1 5376553) (vectors 16 86737) (vector-slots 8 2193760 91134) (floats 8 1421 1328) (intervals 56 170795 1719) (buffers 976 229)) ------------=_1503738245-1817-5-- From unknown Sat Jun 14 19:38:39 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Francesco =?UTF-8?Q?Potort=C3=AC?= Subject: bug#25435: closed (Re: bug#25428: 25.1; Incorrect doc string for `delete-selection-mode') Message-ID: References: <83tw0u66qv.fsf@gnu.org> X-Gnu-PR-Message: they-closed 25435 X-Gnu-PR-Package: emacs Reply-To: 25435@debbugs.gnu.org Date: Sat, 26 Aug 2017 09:04:05 +0000 Content-Type: multipart/mixed; boundary="----------=_1503738245-1817-7" This is a multi-part message in MIME format... ------------=_1503738245-1817-7 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #25428: 25.1; auto-fill-mode is enabled with 1, disabled with 0 which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 25435@debbugs.gnu.org. --=20 25428: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D25428 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1503738245-1817-7 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 25428-done) by debbugs.gnu.org; 26 Aug 2017 09:03:40 +0000 Received: from localhost ([127.0.0.1]:55938 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dlX0G-0000Sl-Ee for submit@debbugs.gnu.org; Sat, 26 Aug 2017 05:03:40 -0400 Received: from eggs.gnu.org ([208.118.235.92]:32955) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dlX0E-0000SY-L0 for 25428-done@debbugs.gnu.org; Sat, 26 Aug 2017 05:03:39 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dlX06-0001Qn-R4 for 25428-done@debbugs.gnu.org; Sat, 26 Aug 2017 05:03:33 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:59437) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dlX06-0001Qh-NV; Sat, 26 Aug 2017 05:03:30 -0400 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4484 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1dlX05-0005XD-NB; Sat, 26 Aug 2017 05:03:30 -0400 Date: Sat, 26 Aug 2017 12:03:20 +0300 Message-Id: <83tw0u66qv.fsf@gnu.org> From: Eli Zaretskii To: Drew Adams In-reply-to: <2e0430c1-4783-4b53-ac95-300282a1a6be@default> (message from Drew Adams on Wed, 16 Aug 2017 20:25:31 -0700 (PDT)) Subject: Re: bug#25428: 25.1; Incorrect doc string for `delete-selection-mode' References: <87efsbrm9u.fsf@moondust.localdomain> <2e0430c1-4783-4b53-ac95-300282a1a6be@default> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: 25428-done Cc: 25428-done@debbugs.gnu.org, nljlistbox2@gmail.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) > Date: Wed, 16 Aug 2017 20:25:31 -0700 (PDT) > From: Drew Adams > Cc: 25428@debbugs.gnu.org > > Let's just say that the doc string is incomplete and can easily > mislead. > > If it says anything about interactive behavior (and it should) > then it should say just what the description of `define-minor-mode' > says for minor modes. > > If it says anything about the behavior when called from > Lisp (and it should) then it should say just what the d-m-m > description says. This (i.e., _all_ of the d-m-m description) > is missing from the d-s-m doc string: > > * `toggle' toggles > * non-positive integer disables > * anything else enables Thanks, I fixed the doc string to include the missing information. ------------=_1503738245-1817-7 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 13 Jan 2017 11:43:26 +0000 Received: from localhost ([127.0.0.1]:52121 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cS0GU-0007Ww-35 for submit@debbugs.gnu.org; Fri, 13 Jan 2017 06:43:26 -0500 Received: from eggs.gnu.org ([208.118.235.92]:60281) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cS0GR-0007Wj-Px for submit@debbugs.gnu.org; Fri, 13 Jan 2017 06:43:24 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cS0GL-00015r-3S for submit@debbugs.gnu.org; Fri, 13 Jan 2017 06:43:18 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-2.4 required=5.0 tests=BAYES_50,RP_MATCHES_RCVD, T_MANY_HDRS_LCASE autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:54201) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1cS0GK-00015l-WB for submit@debbugs.gnu.org; Fri, 13 Jan 2017 06:43:17 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:51246) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cS0GI-0002Be-S8 for bug-gnu-emacs@gnu.org; Fri, 13 Jan 2017 06:43:16 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cS0GE-000138-7s for bug-gnu-emacs@gnu.org; Fri, 13 Jan 2017 06:43:14 -0500 Received: from blade3.isti.cnr.it ([194.119.192.19]:13086) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1cS0GD-000117-Rf for bug-gnu-emacs@gnu.org; Fri, 13 Jan 2017 06:43:10 -0500 Received: from tucano.isti.cnr.it ([146.48.81.102]) by mx.isti.cnr.it (PMDF V6.5-x6 #1251) with ESMTPSA id <01Q9MWR0CGKWDBI2F5@mx.isti.cnr.it> for bug-gnu-emacs@gnu.org; Fri, 13 Jan 2017 12:43:03 +0100 (MET) Received: from pot by tucano.isti.cnr.it with local (Exim 4.88) (envelope-from ) id 1cS0G6-0000ic-8K for bug-gnu-emacs@gnu.org; Fri, 13 Jan 2017 12:43:02 +0100 Date: Fri, 13 Jan 2017 12:43:02 +0100 From: =?utf-8?Q?Francesco_Potort=C3=AC?= Subject: 25.1; auto-fill-mode is enabled with 1, disabled with 0 To: bug-gnu-emacs@gnu.org Message-id: Organization: MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-transfer-encoding: 8bit X-INSM-ip-source: 146.48.81.102 Auth Done X-fingerprint: 4B02 6187 5C03 D6B1 2E31 7666 09DF 2DC9 BE21 6115 X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -8.2 (--------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -8.2 (--------) Contrary to the docs, auto-fill-mode called programmatically is enabled with arg 1 and disabled with arg 0. In GNU Emacs 25.1.1 (x86_64-pc-linux-gnu, X toolkit, Xaw3d scroll bars) of 2016-10-24, modified by Debian built on trouble Windowing system distributor 'The X.Org Foundation', version 11.0.11900000 System Description: Debian GNU/Linux testing (stretch) Configured using: 'configure --build x86_64-linux-gnu --prefix=/usr --sharedstatedir=/var/lib --libexecdir=/usr/lib --localstatedir=/var/lib --infodir=/usr/share/info --mandir=/usr/share/man --with-pop=yes --enable-locallisppath=/etc/emacs25:/etc/emacs:/usr/local/share/emacs/25.1/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/25.1/site-lisp:/usr/share/emacs/site-lisp --with-sound=alsa --build x86_64-linux-gnu --prefix=/usr --sharedstatedir=/var/lib --libexecdir=/usr/lib --localstatedir=/var/lib --infodir=/usr/share/info --mandir=/usr/share/man --with-pop=yes --enable-locallisppath=/etc/emacs25:/etc/emacs:/usr/local/share/emacs/25.1/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/25.1/site-lisp:/usr/share/emacs/site-lisp --with-sound=alsa --with-x=yes --with-x-toolkit=lucid --with-toolkit-scroll-bars --without-gconf --without-gsettings 'CFLAGS=-g -O2 -fdebug-prefix-map=/build/emacs25-25.1+1=. -fstack-protector-strong -Wformat -Werror=format-security -Wall' 'CPPFLAGS=-Wdate-time -D_FORTIFY_SOURCE=2' LDFLAGS=-Wl,-z,relro' Configured features: XAW3D XPM JPEG TIFF GIF PNG RSVG IMAGEMAGICK SOUND GPM DBUS NOTIFY ACL LIBSELINUX GNUTLS LIBXML2 FREETYPE M17N_FLT LIBOTF XFT ZLIB TOOLKIT_SCROLL_BARS LUCID X11 Important settings: value of $LC_COLLATE: it_IT.UTF-8 value of $LC_CTYPE: it_IT.UTF-8 value of $LC_NUMERIC: C value of $LANG: en_US.UTF-8 locale-coding-system: utf-8-unix Major mode: Emacs-Lisp Minor modes in effect: global-visual-fill-column-mode: t diff-auto-refine-mode: t TeX-PDF-mode: t desktop-save-mode: t epa-global-mail-mode: t shell-dirtrack-mode: t openwith-mode: t xterm-mouse-mode: t display-time-mode: t tooltip-mode: t global-eldoc-mode: t electric-indent-mode: t mouse-wheel-mode: t tool-bar-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t column-number-mode: t line-number-mode: t auto-fill-function: do-auto-fill Recent messages: Modification-flag cleared Counting messages...done Showing message 63...done Showing message 63...done Showing message 62...done Showing message 61...done Showing message 60...done Showing message 63...done Mark set Making completion list... Load-path shadows: ~/elisp/bhl hides /usr/share/emacs/site-lisp/bhl /usr/share/emacs25/site-lisp/flim/md4 hides /usr/share/emacs/25.1/lisp/md4 /usr/share/emacs25/site-lisp/flim/hex-util hides /usr/share/emacs/25.1/lisp/hex-util /usr/share/emacs/site-lisp/rst hides /usr/share/emacs/25.1/lisp/textmodes/rst ~/elisp/bibtex hides /usr/share/emacs/25.1/lisp/textmodes/bibtex /usr/share/emacs25/site-lisp/flim/ntlm hides /usr/share/emacs/25.1/lisp/net/ntlm /usr/share/emacs25/site-lisp/flim/hmac-md5 hides /usr/share/emacs/25.1/lisp/net/hmac-md5 /usr/share/emacs25/site-lisp/flim/sasl-ntlm hides /usr/share/emacs/25.1/lisp/net/sasl-ntlm /usr/share/emacs25/site-lisp/flim/sasl-digest hides /usr/share/emacs/25.1/lisp/net/sasl-digest /usr/share/emacs25/site-lisp/flim/sasl hides /usr/share/emacs/25.1/lisp/net/sasl /usr/share/emacs25/site-lisp/flim/sasl-cram hides /usr/share/emacs/25.1/lisp/net/sasl-cram /usr/share/emacs25/site-lisp/flim/hmac-def hides /usr/share/emacs/25.1/lisp/net/hmac-def /usr/share/emacs25/site-lisp/auctex/tex-fold hides /usr/share/emacs/site-lisp/auctex/tex-fold /usr/share/emacs25/site-lisp/auctex/context-en hides /usr/share/emacs/site-lisp/auctex/context-en /usr/share/emacs25/site-lisp/auctex/tex-info hides /usr/share/emacs/site-lisp/auctex/tex-info /usr/share/emacs25/site-lisp/auctex/plain-tex hides /usr/share/emacs/site-lisp/auctex/plain-tex /usr/share/emacs25/site-lisp/auctex/tex-mik hides /usr/share/emacs/site-lisp/auctex/tex-mik /usr/share/emacs25/site-lisp/auctex/texmathp hides /usr/share/emacs/site-lisp/auctex/texmathp /usr/share/emacs25/site-lisp/auctex/context-nl hides /usr/share/emacs/site-lisp/auctex/context-nl /usr/share/emacs25/site-lisp/auctex/toolbar-x hides /usr/share/emacs/site-lisp/auctex/toolbar-x /usr/share/emacs25/site-lisp/auctex/tex hides /usr/share/emacs/site-lisp/auctex/tex /usr/share/emacs25/site-lisp/auctex/tex-jp hides /usr/share/emacs/site-lisp/auctex/tex-jp /usr/share/emacs25/site-lisp/auctex/bib-cite hides /usr/share/emacs/site-lisp/auctex/bib-cite /usr/share/emacs25/site-lisp/auctex/multi-prompt hides /usr/share/emacs/site-lisp/auctex/multi-prompt /usr/share/emacs25/site-lisp/auctex/font-latex hides /usr/share/emacs/site-lisp/auctex/font-latex /usr/share/emacs25/site-lisp/auctex/prv-emacs hides /usr/share/emacs/site-lisp/auctex/prv-emacs /usr/share/emacs25/site-lisp/auctex/tex-style hides /usr/share/emacs/site-lisp/auctex/tex-style /usr/share/emacs25/site-lisp/auctex/context hides /usr/share/emacs/site-lisp/auctex/context /usr/share/emacs25/site-lisp/auctex/preview hides /usr/share/emacs/site-lisp/auctex/preview /usr/share/emacs25/site-lisp/auctex/tex-font hides /usr/share/emacs/site-lisp/auctex/tex-font /usr/share/emacs25/site-lisp/auctex/tex-bar hides /usr/share/emacs/site-lisp/auctex/tex-bar /usr/share/emacs25/site-lisp/auctex/latex hides /usr/share/emacs/site-lisp/auctex/latex /usr/share/emacs25/site-lisp/auctex/tex-buf hides /usr/share/emacs/site-lisp/auctex/tex-buf ~/elisp/bhl hides /usr/share/emacs25/site-lisp/bhl /usr/share/emacs/site-lisp/debian-startup hides /usr/share/emacs25/site-lisp/debian-startup Features: (ruler-mode cal-x debug two-column iso-transl apropos pcmpl-gnu pcmpl-linux macros python tramp-sh tar-mode anything-config anything woman mailcap undigest cal-move smerge-mode diff doc-view vc-cvs pcmpl-unix json-mode rx cus-edit wid-edit cus-start cus-load rmailedit tabify man vc-dir ewoc tramp-cache shadow emacsbug reporter debian-bug mail-extr texmathp nxml-uchnm rng-xsd xsd-regexp rng-cmpct rng-nxml rng-valid rng-loc rng-uri rng-parse nxml-parse rng-match rng-dt rng-util rng-pttrn nxml-ns nxml-mode nxml-outln nxml-rap nxml-util nxml-glyph nxml-enc xmltok tmm ido etags xref project ediff-merg ediff-wind ediff-diff ediff-mult ediff-help ediff-init ediff-util ediff js json map imenu ispell log-view pp visual-fill-column locate dired-aux eieio-opt speedbar sb-image ezimage dframe find-func timezone rmailsort face-remap url-handlers nero cl rect log-edit pcvs-util add-log grep dabbrev diff-mode vc rmailkwd mailalias rmailout shr-color color time-stamp misearch multi-isearch server parse-time unrmail qp url-util shr dom subr-x browse-url jka-compr cc-mode cc-fonts cc-guess cc-menus cc-cmds cc-styles cc-align cc-engine cc-vars cc-defs bibtex info sh-script executable sgml-mode vc-filewise vc-rcs image-mode view conf-mode generic octave smie latexenc plain-tex vc-dispatcher vc-svn preview prv-emacs tex-bar tex-buf toolbar-x noutline outline font-latex latex easy-mmode edmacro kmacro tex-style tex dbus xml crm tex-mode compile rmailmm message rfc822 mml mml-sec mm-decode mm-bodies mm-encode mailabbrev gmm-utils mailheader mail-parse rfc2231 desktop frameset term/xterm xterm pot skeleton rmailsum rmail warnings sendmail rfc2047 rfc2045 ietf-drums mime-compose epa-mail mail-utils epa derived epg cal-china lunar solar cal-dst cal-bahai cal-islam cal-hebrew holidays hol-loaddefs vc-hg appt diary-lib diary-loaddefs cal-menu calendar cal-loaddefs tramp tramp-compat tramp-loaddefs trampver ucs-normalize shell pcomplete comint ring format-spec bhl switch-to-shell openwith hi-lock xt-mouse ffap thingatpt url-parse auth-source cl-seq eieio eieio-core cl-macs gnus-util time-date mm-util help-fns mail-prsvr password-cache url-vars scroll-in-place filladapt ansi-color advice time quail dired-x dired generic-x disp-table finder-inf package epg-config seq byte-opt gv bytecomp byte-compile cl-extra help-mode easymenu cconv cl-loaddefs pcase cl-lib debian-el debian-el-loaddefs w3m-load vm-autoload vm-autoloads vm-version vm-vars vm-init preview-latex tex-site auto-loads mule-util tooltip eldoc electric uniquify ediff-hook vc-hooks lisp-float-type mwheel x-win term/common-win x-dnd tool-bar dnd fontset image regexp-opt fringe tabulated-list newcomment elisp-mode lisp-mode prog-mode register page menu-bar rfn-eshadow timer select scroll-bar mouse jit-lock font-lock syntax facemenu font-core frame cl-generic cham georgian utf-8-lang misc-lang vietnamese tibetan thai tai-viet lao korean japanese eucjp-ms cp51932 hebrew greek romanian slovak czech european ethiopic indian cyrillic chinese charscript case-table epa-hook jka-cmpr-hook help simple abbrev minibuffer cl-preloaded nadvice loaddefs button faces cus-face macroexp files text-properties overlay sha1 md5 base64 format env code-pages mule custom widget hashtable-print-readable backquote dbusbind inotify dynamic-setting font-render-setting x-toolkit x multi-tty make-network-process emacs) Memory information: ((conses 16 1176401 152830) (symbols 48 60421 2) (miscs 40 8567 6832) (strings 32 175183 30285) (string-bytes 1 6034750) (vectors 16 86801) (vector-slots 8 2197329 87565) (floats 8 1420 1360) (intervals 56 170521 2615) (buffers 976 232)) ------------=_1503738245-1817-7--