From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Emanuel Berg Newsgroups: gmane.emacs.bugs Subject: bug#35163: 25.1; `narrow-to-region' docstring no mention of args Date: Fri, 05 Apr 2019 21:26:55 +0200 Message-ID: <86wok8dzi8.fsf@zoho.eu> References: <868swoffpi.fsf@zoho.eu> <83ftqwb788.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="67688"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1 (gnu/linux) Cc: 35163@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Apr 05 22:06:24 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1hCV6U-000HQH-OB for geb-bug-gnu-emacs@m.gmane.org; Fri, 05 Apr 2019 22:06:23 +0200 Original-Received: from localhost ([127.0.0.1]:46271 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hCV6T-0003kh-Fi for geb-bug-gnu-emacs@m.gmane.org; Fri, 05 Apr 2019 16:06:21 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:60122) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hCV6L-0003kQ-KU for bug-gnu-emacs@gnu.org; Fri, 05 Apr 2019 16:06:14 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hCV6F-0003PJ-65 for bug-gnu-emacs@gnu.org; Fri, 05 Apr 2019 16:06:09 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:32773) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hCV5w-0002tJ-Kj for bug-gnu-emacs@gnu.org; Fri, 05 Apr 2019 16:06:04 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hCUVN-0001Zn-NP for bug-gnu-emacs@gnu.org; Fri, 05 Apr 2019 15:28:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Emanuel Berg Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 05 Apr 2019 19:28:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 35163 X-GNU-PR-Package: emacs Original-Received: via spool by 35163-submit@debbugs.gnu.org id=B35163.15544924225993 (code B ref 35163); Fri, 05 Apr 2019 19:28:01 +0000 Original-Received: (at 35163) by debbugs.gnu.org; 5 Apr 2019 19:27:02 +0000 Original-Received: from localhost ([127.0.0.1]:46315 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCUUP-0001YS-Ij for submit@debbugs.gnu.org; Fri, 05 Apr 2019 15:27:01 -0400 Original-Received: from sender-pp-o92.zoho.eu ([185.20.209.252]:25745) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCUUN-0001YB-LJ for 35163@debbugs.gnu.org; Fri, 05 Apr 2019 15:27:00 -0400 ARC-Seal: i=1; a=rsa-sha256; t=1554492417; cv=none; d=zohomail.eu; s=zohoarc; b=KEiINO4O/iK1IpVcggSDeK37Nq4y7I+w8bR3XWzoevFEvblIiL45AqQzK96O62AXgMNjFFXjvUGQvHdM5WmI2Z4Aomo+/axgGq6B+CD6daQrxnpftGvC8ukouyhVBFyx3S5X1GQUTZXaQOfg17HFDnkpyhPqM9xAxq3TaVF+vDE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.eu; s=zohoarc; t=1554492417; h=Content-Type:Cc:Date:From:In-Reply-To:MIME-Version:Message-ID:References:Subject:To:ARC-Authentication-Results; bh=kJMIU5ex7IFN1erpIAiyWzlPuvaObFPMAOKT1NcNb2w=; b=DHOqTYqT0nsIYlhoFsVKzaFV64j3T+QoNxuNUItPIlEuWAUSutYCTqgp5F7Lg0Dk0kEclBsqZcrw4FNu4TbAqMxlkGkjic1HJXYSvIKe2o0f6eaSSVIDJZ1S2q2okisY6C8ANcl/WlzE3kpBayF1rJD4hYfFULNQ/nmQpF9aqRU= ARC-Authentication-Results: i=1; mx.zohomail.eu; dkim=pass header.i=zoho.eu; spf=pass smtp.mailfrom=moasenwood@zoho.eu; dmarc=pass header.from= header.from= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; t=1554492417; s=admin; d=zoho.eu; i=moasenwood@zoho.eu; h=From:To:Cc:Subject:References:Date:In-Reply-To:Message-ID:MIME-Version:Content-Type; l=872; bh=kJMIU5ex7IFN1erpIAiyWzlPuvaObFPMAOKT1NcNb2w=; b=M9dwpZbHsCNY5kcwoG9PpD6YVjKp9ek854uzFbwR4P4mkEKxi/t+ZkDd9YnqP3WP upM5dsxA7BfSHUz16ykFwsljSP3h8Jnie/C9yyEE2d14OeqAwoj0mvHAAjux1ui+8+Z +fzyV49cBVBjPbmz7AoCxnU4bZSsrLXv3TkMEHwc= Original-Received: from raspberrypi.zoho.eu (c-b895225c.021-67-7570702.bbcust.telenor.se [92.34.149.184]) by mx.zoho.eu with SMTPS id 1554492416469138.60186554145446; Fri, 5 Apr 2019 21:26:56 +0200 (CEST) Mail-Copies-To: never In-Reply-To: <83ftqwb788.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 05 Apr 2019 22:08:23 +0300") X-ZohoMailClient: External X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.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" Xref: news.gmane.org gmane.emacs.bugs:157234 Archived-At: Eli Zaretskii wrote: >> From: Emanuel Berg >> Date: Fri, 05 Apr 2019 20:51:37 +0200 >> >> 25.1; `narrow-to-region' docstring no >> mention of args >> >> The `narrow-to-region' docstring does not >> mention its arguments as is the norm. > > It does: > > When calling from a program, pass two > arguments; positions (integers or markers) > bounding the text that should remain visible. The words START and END do not appear, in that order, in the docstring. Actually, they don't appear at all. That means they are not searchable. (checkdoc-current-buffer t) would tell you this if you run it in an Elisp pack. If you run it in a C file, I don't know what will happen, but the principle is still a good idea both from a principal and a practical standpoint. -- underground experts united http://user.it.uu.se/~embe8573