From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#35163: 25.1; `narrow-to-region' docstring no mention of args Date: Sat, 06 Apr 2019 09:25:17 +0300 Message-ID: <83bm1jbqgi.fsf@gnu.org> References: <868swoffpi.fsf@zoho.eu> <83ftqwb788.fsf@gnu.org> <86wok8dzi8.fsf@zoho.eu> Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="65083"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 35163@debbugs.gnu.org To: Emanuel Berg Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Apr 06 08:26:10 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 1hCemI-000Gka-LK for geb-bug-gnu-emacs@m.gmane.org; Sat, 06 Apr 2019 08:26:10 +0200 Original-Received: from localhost ([127.0.0.1]:51236 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hCemH-0004eY-Fu for geb-bug-gnu-emacs@m.gmane.org; Sat, 06 Apr 2019 02:26:09 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:56002) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hCemB-0004eT-F7 for bug-gnu-emacs@gnu.org; Sat, 06 Apr 2019 02:26:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hCemA-00045w-J8 for bug-gnu-emacs@gnu.org; Sat, 06 Apr 2019 02:26:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:32941) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hCem9-00045b-VB for bug-gnu-emacs@gnu.org; Sat, 06 Apr 2019 02:26:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hCem9-0002OT-Mn for bug-gnu-emacs@gnu.org; Sat, 06 Apr 2019 02:26:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 06 Apr 2019 06:26: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.15545319379169 (code B ref 35163); Sat, 06 Apr 2019 06:26:01 +0000 Original-Received: (at 35163) by debbugs.gnu.org; 6 Apr 2019 06:25:37 +0000 Original-Received: from localhost ([127.0.0.1]:46485 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCelk-0002Np-SG for submit@debbugs.gnu.org; Sat, 06 Apr 2019 02:25:37 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:41475) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCeli-0002Na-Ig for 35163@debbugs.gnu.org; Sat, 06 Apr 2019 02:25:34 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:36857) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hCelc-0003n4-O5; Sat, 06 Apr 2019 02:25:29 -0400 Original-Received: from [176.228.60.248] (port=3747 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hCelb-0002t1-UZ; Sat, 06 Apr 2019 02:25:28 -0400 In-reply-to: <86wok8dzi8.fsf@zoho.eu> (message from Emanuel Berg on Fri, 05 Apr 2019 21:26:55 +0200) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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:157246 Archived-At: > From: Emanuel Berg > Cc: 35163@debbugs.gnu.org > Date: Fri, 05 Apr 2019 21:26:55 +0200 > > 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. This is a command, first and foremost. The primary goal of its doc string is to tell users (not Lisp programmers) how to use the command and what it does. In interactive usage, START and END come from the region and are not under user control explicitly. So I don't think there's anything wrong with this doc string.