From debbugs-submit-bounces@debbugs.gnu.org Mon Aug 04 14:33:38 2014 Received: (at submit) by debbugs.gnu.org; 4 Aug 2014 18:33:38 +0000 Received: from localhost ([127.0.0.1]:57557 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XEN4j-00024G-Nc for submit@debbugs.gnu.org; Mon, 04 Aug 2014 14:33:38 -0400 Received: from eggs.gnu.org ([208.118.235.92]:32946) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XEN4h-00023z-J6 for submit@debbugs.gnu.org; Mon, 04 Aug 2014 14:33:36 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XEN4b-00050u-Bc for submit@debbugs.gnu.org; Mon, 04 Aug 2014 14:33:30 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.0 required=5.0 tests=BAYES_40,HTML_MESSAGE, T_DKIM_INVALID autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:33420) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XEN4b-00050n-8H for submit@debbugs.gnu.org; Mon, 04 Aug 2014 14:33:29 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:34661) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XEN4a-0000Ql-0I for bug-gnu-emacs@gnu.org; Mon, 04 Aug 2014 14:33:29 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XEN4V-0004xk-13 for bug-gnu-emacs@gnu.org; Mon, 04 Aug 2014 14:33:27 -0400 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:44297) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XEN4U-0004xg-UC for bug-gnu-emacs@gnu.org; Mon, 04 Aug 2014 14:33:22 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:58800) by fencepost.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1XEN4U-0005Oa-M3 for bug-emacs@gnu.org; Mon, 04 Aug 2014 14:33:22 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XEN4T-0004x2-La for bug-emacs@gnu.org; Mon, 04 Aug 2014 14:33:22 -0400 Received: from mail-la0-x236.google.com ([2a00:1450:4010:c03::236]:34696) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XEN4T-0004wj-Bz for bug-emacs@gnu.org; Mon, 04 Aug 2014 14:33:21 -0400 Received: by mail-la0-f54.google.com with SMTP id hz20so5623801lab.41 for ; Mon, 04 Aug 2014 11:33:20 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sc3d.org; s=google; h=mime-version:date:message-id:subject:from:to:content-type; bh=wXxdn+B+lUZJteWPIhFQc/ZxCWnRxJ5kn+jjcyGtOHM=; b=xyOKQZyJStOIKjS7vfuHjLX7TjEPagm05digigS4D3A4+AW66Xx1aoi/lWRn/O11R8 Z/bwNQpfwjlHBH+vAtYdPh0BvycPT5rKNhzNPk7vwCcKyw48bkAId4pHnY+JdxvV800b X6nqWGxVSvl2klbUhbmbuPGEfC7tn/JBR6Pgs= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:date:message-id:subject:from:to :content-type; bh=wXxdn+B+lUZJteWPIhFQc/ZxCWnRxJ5kn+jjcyGtOHM=; b=M1a1atjZGgkSwsYFflrRgi82+4tyqMH/TWz+FUOuvKg/fKZzeC5yt5RyYtnlmYjOYr aSo/L5mUYFvZG1raN0i+fjcEur5BccWeNRkYA5uZuu/HSP2A2E0YtjaqxmBFqiFtpxl5 l20HUqUeHPmT086VvP0EEtC7reA/U5gH5duledzmdL6+lkwOykKNn3AowwwGrnjoa8+O lHua9gn7hZ07ROC0146VodaJ2vzLcDQCmHOJ5tdADfC7VI4qryI4In+y1za8oKSMuhwo f+iw2Om5ub5doocmT+7CLg5o+YtZixkLbL0twxxkO5F5pFT0t+UoOmQoat7oxk+AZ3wq FWSg== X-Gm-Message-State: ALoCoQlo8AcW+CaVABak2SyG9uBFqopudmOhKoeUbMjp+eAy062AoevzH7FLFI1b17DUfSw40lZ4 MIME-Version: 1.0 X-Received: by 10.112.2.167 with SMTP id 7mr3922519lbv.103.1407177199928; Mon, 04 Aug 2014 11:33:19 -0700 (PDT) Received: by 10.152.246.10 with HTTP; Mon, 4 Aug 2014 11:33:19 -0700 (PDT) Date: Mon, 4 Aug 2014 19:33:19 +0100 Message-ID: Subject: Incorrect implication in delete-{backward,forward}-char docstrings From: Reuben Thomas To: bug-emacs Content-Type: multipart/alternative; boundary=14dae94ee019235fdc04ffd1f9d8 X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.1 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 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.1 (----) --14dae94ee019235fdc04ffd1f9d8 Content-Type: text/plain; charset=UTF-8 These two functions are marked interactive-only, yet the docstrings' last sentence starts "Interactively," which may lead readers to infer that they can be used non-interactively: Interactively, N is the prefix arg, and KILLFLAG is set if N was explicitly specified. How about the following re-wording for the last sentence: "A prefix arg becomes N, and sets KILLFLAG." In fact, this solves another confusion: is pressing C-u "explicitly" setting N? It might seem not, but it certainly causes KILLFLAG to be set. If this is satisfactory, I can install a fix. -- http://rrt.sc3d.org --14dae94ee019235fdc04ffd1f9d8 Content-Type: text/html; charset=UTF-8
These two functions are marked interactive-only, yet the docstrings' last sentence starts "Interactively," which may lead readers to infer that they can be used non-interactively:

Interactively, N is the prefix arg, and
KILLFLAG is set if N was explicitly specified.

How about the following re-wording for the last sentence:

"A prefix arg becomes N, and sets KILLFLAG."

In fact, this solves another confusion: is pressing C-u "explicitly" setting N? It might seem not, but it certainly causes KILLFLAG to be set.

If this is satisfactory, I can install a fix.
--14dae94ee019235fdc04ffd1f9d8-- From debbugs-submit-bounces@debbugs.gnu.org Sat Aug 03 15:14:02 2019 Received: (at 18192) by debbugs.gnu.org; 3 Aug 2019 19:14:02 +0000 Received: from localhost ([127.0.0.1]:59949 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htzTd-00066u-T3 for submit@debbugs.gnu.org; Sat, 03 Aug 2019 15:14:02 -0400 Received: from quimby.gnus.org ([80.91.231.51]:52186) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htzTb-00066P-KG for 18192@debbugs.gnu.org; Sat, 03 Aug 2019 15:14:00 -0400 Received: from 77.18.62.220.tmi.telenormobil.no ([77.18.62.220] helo=sandy) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1htzTW-0007D8-U9; Sat, 03 Aug 2019 21:13:57 +0200 From: Lars Ingebrigtsen To: Reuben Thomas Subject: Re: bug#18192: Incorrect implication in delete-{backward,forward}-char docstrings References: Date: Sat, 03 Aug 2019 21:13:54 +0200 In-Reply-To: (Reuben Thomas's message of "Mon, 4 Aug 2014 19:33:19 +0100") Message-ID: <87k1budpu5.fsf@mouse.gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Reuben Thomas writes: > These two functions are marked interactive-only, yet the docstrings' last > sentence starts "Interactively, " which may lead readers to infer that they can > be used non-interactively: > > Interactiv [...] Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP 0.0 TVD_RCVD_IP Message was received from an IP address -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 18192 Cc: 18192@debbugs.gnu.org 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: -1.0 (-) Reuben Thomas writes: > These two functions are marked interactive-only, yet the docstrings' last > sentence starts "Interactively," which may lead readers to infer that they can > be used non-interactively: > > Interactively, N is the prefix arg, and > KILLFLAG is set if N was explicitly specified. > > How about the following re-wording for the last sentence: > > "A prefix arg becomes N, and sets KILLFLAG." > > In fact, this solves another confusion: is pressing C-u "explicitly" setting N? > It might seem not, but it certainly causes KILLFLAG to be set. It a bit confusingly worded, and I've now installed the following phrase instead: "If called interactively, a numeric prefix argument specifies N, and KILLFLAG is also set if a prefix argument is used." While these functions are just supposed to be used interactively, they can be used non-interactively, so I think it's right to call out the "if called interactively" here, too. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Sat Aug 03 15:14:07 2019 Received: (at control) by debbugs.gnu.org; 3 Aug 2019 19:14:07 +0000 Received: from localhost ([127.0.0.1]:59952 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htzTj-00067T-6r for submit@debbugs.gnu.org; Sat, 03 Aug 2019 15:14:07 -0400 Received: from quimby.gnus.org ([80.91.231.51]:52204) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1htzTh-00067F-6b for control@debbugs.gnu.org; Sat, 03 Aug 2019 15:14:05 -0400 Received: from 77.18.62.220.tmi.telenormobil.no ([77.18.62.220] helo=sandy) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1htzTe-0007DI-JK for control@debbugs.gnu.org; Sat, 03 Aug 2019 21:14:04 +0200 Date: Sat, 03 Aug 2019 21:14:02 +0200 Message-Id: <87imredptx.fsf@mouse.gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #18192 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: tags 18192 fixed close 18192 27.1 quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP 0.0 TVD_RCVD_IP Message was received from an IP address -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) 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: -1.0 (-) tags 18192 fixed close 18192 27.1 quit From unknown Sun Aug 17 01:49:34 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 01 Sep 2019 11:24:07 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator