From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Noam Postavsky Newsgroups: gmane.emacs.bugs Subject: bug#35163: 25.1; `narrow-to-region' docstring no mention of args Date: Mon, 08 Apr 2019 19:09:39 -0400 Message-ID: <87d0lwccwc.fsf_-_@gmail.com> References: <834l788mjc.fsf@gnu.org> <868swoffpi.fsf@zoho.eu> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="129643"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.1.91 (gnu/linux) Cc: , Emanuel Berg To: 35163@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Apr 09 01:10:11 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 1hDdP0-000Xbz-JH for geb-bug-gnu-emacs@m.gmane.org; Tue, 09 Apr 2019 01:10:10 +0200 Original-Received: from localhost ([127.0.0.1]:60278 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hDdOz-000360-IU for geb-bug-gnu-emacs@m.gmane.org; Mon, 08 Apr 2019 19:10:09 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:33526) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hDdOu-00035p-0j for bug-gnu-emacs@gnu.org; Mon, 08 Apr 2019 19:10:05 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hDdOs-0005VM-Th for bug-gnu-emacs@gnu.org; Mon, 08 Apr 2019 19:10:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:36765) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hDdOs-0005Uj-Fe for bug-gnu-emacs@gnu.org; Mon, 08 Apr 2019 19:10:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hDdOs-000756-6h for bug-gnu-emacs@gnu.org; Mon, 08 Apr 2019 19:10:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Noam Postavsky Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 08 Apr 2019 23:10:02 +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.155476499327198 (code B ref 35163); Mon, 08 Apr 2019 23:10:02 +0000 Original-Received: (at 35163) by debbugs.gnu.org; 8 Apr 2019 23:09:53 +0000 Original-Received: from localhost ([127.0.0.1]:50308 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hDdOi-00074c-OW for submit@debbugs.gnu.org; Mon, 08 Apr 2019 19:09:52 -0400 Original-Received: from mail-qk1-f181.google.com ([209.85.222.181]:40428) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hDdOc-00074K-L9 for 35163@debbugs.gnu.org; Mon, 08 Apr 2019 19:09:49 -0400 Original-Received: by mail-qk1-f181.google.com with SMTP id w20so9111819qka.7 for <35163@debbugs.gnu.org>; Mon, 08 Apr 2019 16:09:46 -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; bh=D/Z9jvd03yQ8zUIJ8zLVYYfZ6eDZfpNZportgW1eEPU=; b=CBxT7Xe+JsZMHIJCaFsCFbL1SvbXxv+qMJWFGqHaN90eK3+5s3LMJbhdmQiTfkzr/A vx0nvimNogqKdl7f9mOnVN8wxyDNqqUTv1gV/0OBJ21dRIO0JziNDmggXosW1v/az+CQ BS2+M+DJcQ+sCZ0+sTc1D7iAPE+sJOi38DMfcpfTMoYsbRq9VubDJLwHE6bwPU/dO3AS 9h6+4n0yFBNeJPDXytXZJ3oMsNegs1ANxEPtCMwElw/0LA7z3kow234vm6Pmj6Q7pvTm cOhHzwP1XnpGlStk7egbsmEy16S7tIvssWrwraITzlPm0zgCO9V1fvRnfPAmsGmkZ5Ak UjZw== 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; bh=D/Z9jvd03yQ8zUIJ8zLVYYfZ6eDZfpNZportgW1eEPU=; b=MQztTQ4g/ROzwBevlBHjIQfO6jdxe9bVEC901qHusUow7eN/FegMlKef7tJe2rJGpD 0BsxCXVJCsiv62LnFPHW1TYwh4rwZT+ykmeyYWBiqdUy0kxdX51LgAQ36BLBuFuck1ez /b72hmwIKpIS5G4oj33+aUawp4lbvkp4FCahzqBeETP9h6NM13N76Ig8nKHt3hrNrE7E dD9S5E5z3dQR+CsL+OPat+QcEIK45RQElWmHhY7rNuDTrJzWd/fx4BWLw7N2P5FayMbk GLoBdCR5rjhgyyPwvVmiDkttKE1jaju5aYPfybYFa9+sjMiQ0e/F9f6mYxoTtBMb8zN1 QWuA== X-Gm-Message-State: APjAAAVAY28nUGQJn5PIN7X4qCI1Jqht6d36gswK1f87NILDyy6ivuCC RwUFCMl625QwOsB9oIUUsSc= X-Google-Smtp-Source: APXvYqyfduS1PZ2eUtEL3lPFWe63fTFuqknr1X6ArVewNNkXpVOX6+7jOTHysAYhhz2UcL8m6VfeFw== X-Received: by 2002:a37:9906:: with SMTP id b6mr25961298qke.132.1554764981056; Mon, 08 Apr 2019 16:09:41 -0700 (PDT) Original-Received: from minid (cbl-45-2-119-34.yyz.frontiernetworks.ca. [45.2.119.34]) by smtp.googlemail.com with ESMTPSA id t129sm17148297qkc.24.2019.04.08.16.09.40 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 08 Apr 2019 16:09:40 -0700 (PDT) In-Reply-To: (GNU bug Tracking System's message of "Mon, 08 Apr 2019 16:56:02 +0000") 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:157370 Archived-At: > From: Eli Zaretskii >> From: Glenn Morris >> OP wants every doc string to literally contain the upper-case argument >> names, ie START and END in this case (as per eg checkdoc's "Argument ... >> should appear (as ...) in the doc string"). If you agree, it's a trivial >> change. If not, close as wontfix. > > Thanks, fixed. > >> (People who have particular ideas about doc strings could save everyone >> a lot of time by sending patches.) > > Or at least a clear description of the problem. To be fair, message [11] is fairly clear and pretty close to what Glenn wrote (perhaps it misses the emphasis on satisfying checkdoc). Things unfortunately derailed after that. An 80+ line elisp riddle on a report about a docstring bug is surely a sign something has gone horribly wrong... [11]: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=35163#11