From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#28957: 26.0; doc string of `dired-move-to-filename' Date: Sun, 15 Apr 2018 15:39:27 -0700 (PDT) Message-ID: <1b5a83fc-b2c9-4dce-9120-f6bb9416bc2f@default> References: <87po3070bl.fsf@mouse.gnus.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1523831888 8005 195.159.176.226 (15 Apr 2018 22:38:08 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 15 Apr 2018 22:38:08 +0000 (UTC) Cc: 28957@debbugs.gnu.org To: Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Apr 16 00:38:04 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f7qHZ-0001xZ-Kw for geb-bug-gnu-emacs@m.gmane.org; Mon, 16 Apr 2018 00:38:01 +0200 Original-Received: from localhost ([::1]:48802 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f7qJg-0008Ip-5t for geb-bug-gnu-emacs@m.gmane.org; Sun, 15 Apr 2018 18:40:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:44116) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f7qJZ-0008Ic-S4 for bug-gnu-emacs@gnu.org; Sun, 15 Apr 2018 18:40:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1f7qJW-0004R0-LY for bug-gnu-emacs@gnu.org; Sun, 15 Apr 2018 18:40:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:46805) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1f7qJW-0004Qk-Gf for bug-gnu-emacs@gnu.org; Sun, 15 Apr 2018 18:40:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1f7qJW-00080I-6b for bug-gnu-emacs@gnu.org; Sun, 15 Apr 2018 18:40:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 15 Apr 2018 22:40:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 28957 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: wontfix Original-Received: via spool by 28957-submit@debbugs.gnu.org id=B28957.152383197930734 (code B ref 28957); Sun, 15 Apr 2018 22:40:02 +0000 Original-Received: (at 28957) by debbugs.gnu.org; 15 Apr 2018 22:39:39 +0000 Original-Received: from localhost ([127.0.0.1]:54702 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f7qJ9-0007ze-60 for submit@debbugs.gnu.org; Sun, 15 Apr 2018 18:39:39 -0400 Original-Received: from userp2120.oracle.com ([156.151.31.85]:56970) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f7qJ7-0007zN-VI for 28957@debbugs.gnu.org; Sun, 15 Apr 2018 18:39:38 -0400 Original-Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w3FMaB5Y056163; Sun, 15 Apr 2018 22:39:31 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2017-10-26; bh=WAytC6JoP9eA8+Dpl0WEe0X7gea5LZeuoVkJh+1eChg=; b=m7ulxcgmpqsYLwRgm/dx2mpfzDAcx4ln9ft83Lamtb0Kl4JiBTMe/CE5RYiREPHrwwqg +HS2x0G4FSB5A2WJwWX3aV2k/v7pfGhfwMNdsJjUfBOQtZDiax2gsKrFqEltgaitA42K i2q9BNNUnw+LcMhHic6GpW9ZiHolpdmfHRh8e6GjftroDH9alLYAK8tqc+XWWT5L4cPB 2Nx9Od49NF7f1uwGTQOWzCXXPw4hhmwZhGlbzpOTJhwoQYo/tW1HIyPTUj66XnaQRTrX jsLAfyaj7EQTvAX+HbIFIcUzHr/uWgqIurub888gucyKH0LhZBwYUVSWjfkON5PUrzAc iw== Original-Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by userp2120.oracle.com with ESMTP id 2hbam52qqt-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 15 Apr 2018 22:39:31 +0000 Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserv0021.oracle.com (8.14.4/8.14.4) with ESMTP id w3FMdUxO025335 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 15 Apr 2018 22:39:30 GMT Original-Received: from abhmp0001.oracle.com (abhmp0001.oracle.com [141.146.116.7]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id w3FMdTos005777; Sun, 15 Apr 2018 22:39:29 GMT In-Reply-To: <87po3070bl.fsf@mouse.gnus.org> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4678.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=8864 signatures=668698 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=651 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1711220000 definitions=main-1804150227 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: 208.118.235.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:145421 Archived-At: > > Please describe the parameters, RAISE-ERROR and EOL, in the doc string. >=20 > Nah. Those parameters are so obscure that you'd have to put the entire > function in the doc string to explain them. Especially RAISE-ERROR. That's a cop-out, and it flouts Emacs convention. Users deserve better. Your comment is of course welcome. But closing the bug is inappropriate - c'est un bug. If you don't want to fix it, or you don't know how, why not at least leave it open for someone else to fix who might want to and knows how? Are you not finding enough Gnus bugs to close? ;-)