From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.bugs Subject: bug#10507: 24.0.92; Doc of `search-forward' (and backward) Date: Mon, 16 Jan 2012 10:21:30 -0500 Message-ID: References: <4F0FFFB47E574B9D9DF35AD518F331AC@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1326727345 26650 80.91.229.12 (16 Jan 2012 15:22:25 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Mon, 16 Jan 2012 15:22:25 +0000 (UTC) Cc: 10507@debbugs.gnu.org To: "Drew Adams" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jan 16 16:22:21 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1RmoO5-000090-0h for geb-bug-gnu-emacs@m.gmane.org; Mon, 16 Jan 2012 16:22:21 +0100 Original-Received: from localhost ([::1]:55378 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RmoO4-0003sQ-Gk for geb-bug-gnu-emacs@m.gmane.org; Mon, 16 Jan 2012 10:22:20 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:36384) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RmoNy-0003sI-Hd for bug-gnu-emacs@gnu.org; Mon, 16 Jan 2012 10:22:18 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RmoNr-0001Hy-LZ for bug-gnu-emacs@gnu.org; Mon, 16 Jan 2012 10:22:14 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:37539) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RmoNr-0001Ht-Ju for bug-gnu-emacs@gnu.org; Mon, 16 Jan 2012 10:22:07 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1RmoOj-00015E-PW for bug-gnu-emacs@gnu.org; Mon, 16 Jan 2012 10:23:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Monnier Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 16 Jan 2012 15:23:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 10507 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 10507-submit@debbugs.gnu.org id=B10507.13267273674142 (code B ref 10507); Mon, 16 Jan 2012 15:23:01 +0000 Original-Received: (at 10507) by debbugs.gnu.org; 16 Jan 2012 15:22:47 +0000 Original-Received: from localhost ([127.0.0.1]:60445 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RmoOU-00014k-3e for submit@debbugs.gnu.org; Mon, 16 Jan 2012 10:22:46 -0500 Original-Received: from ironport2-out.teksavvy.com ([206.248.154.181]:41487) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RmoOQ-00014c-KN for 10507@debbugs.gnu.org; Mon, 16 Jan 2012 10:22:44 -0500 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: Av8EAD5AFE9FxKkV/2dsb2JhbABDqwiBJYEKgQaBcgEBBAFWIwULCzQSFBgNJIgNtW2JXQIBAQgCDBEDCQEBBgEFHgoEAQIBAQUDAQEBAQKCeAEGAgMHAQQBAQEBEgUDDRACAwIBAQMBAYNIBIg7mmOEUg X-IronPort-AV: E=Sophos;i="4.71,518,1320642000"; d="scan'208";a="156996481" Original-Received: from 69-196-169-21.dsl.teksavvy.com (HELO ceviche.home) ([69.196.169.21]) by ironport2-out.teksavvy.com with ESMTP/TLS/ADH-AES256-SHA; 16 Jan 2012 10:21:30 -0500 Original-Received: by ceviche.home (Postfix, from userid 20848) id 416396610D; Mon, 16 Jan 2012 10:21:30 -0500 (EST) In-Reply-To: <4F0FFFB47E574B9D9DF35AD518F331AC@us.oracle.com> (Drew Adams's message of "Mon, 16 Jan 2012 06:51:16 -0800") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.92 (gnu/linux) 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:55793 Archived-At: >> > Furthermore, the doc says explicitly that the 4th arg MUST >> > BE POSITIVE. That is no only NOT the case, it is even the >> > case that the Emacs lisp code uses a negative value as the >> > 4th arg. See, e.g., `zap-to-char'. >> >> "MUST BE POSITIVE" doesn't mean that a negative argument will >> be rejected. So the doc is perfectly allowed to say "MUST BE >> POSITIVE" even if the code handles negative values (it just >> means that negative values are "NOT SUPPORTED"). And if some >> core code uses negative values, that's a naughty breach of >> abstraction, but that's about it. > Words, even words like "must", can always be somewhat ambiguous. But "must" > generally implies some sort of enforcement or negative consequences if not > respected. "MUST" here means it's prohibited to send a negative value. That doesn't mean that if you do you'll get caught, nor how you'll get caught. >> So I see no bug here. If you want a change, please say which and why. > A negative arg is supported by the code; it is used by Emacs source > code; and it is useful. Knowing about it will mean simpler code by > users. Please document (and support) it. Thx. That is a much better bug-report, thank you. Stefan