From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#7758: 24.0.50; doc string and args of `dired-revert' Date: Wed, 29 Dec 2010 11:10:31 -0800 Message-ID: <4C083E1AA7374145BE4DE04F8E028E11@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1293650692 23161 80.91.229.12 (29 Dec 2010 19:24:52 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 29 Dec 2010 19:24:52 +0000 (UTC) To: 7758@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Dec 29 20:24:48 2010 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PY1cb-0003JO-Rs for geb-bug-gnu-emacs@m.gmane.org; Wed, 29 Dec 2010 20:24:47 +0100 Original-Received: from localhost ([127.0.0.1]:51947 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PY1cW-0008Dr-0O for geb-bug-gnu-emacs@m.gmane.org; Wed, 29 Dec 2010 14:23:36 -0500 Original-Received: from [140.186.70.92] (port=33722 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PY1cP-0008Bn-RZ for bug-gnu-emacs@gnu.org; Wed, 29 Dec 2010 14:23:31 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PY1cO-0007UI-Qr for bug-gnu-emacs@gnu.org; Wed, 29 Dec 2010 14:23:29 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:42722) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PY1cO-0007UE-P9 for bug-gnu-emacs@gnu.org; Wed, 29 Dec 2010 14:23:28 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1PY1LV-0000kk-L3; Wed, 29 Dec 2010 14:06:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 29 Dec 2010 19:06:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 7758 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.12936495042830 (code B ref -1); Wed, 29 Dec 2010 19:06:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 29 Dec 2010 19:05:04 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PY1KZ-0000ja-M4 for submit@debbugs.gnu.org; Wed, 29 Dec 2010 14:05:03 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PY1KY-0000j9-Ox for submit@debbugs.gnu.org; Wed, 29 Dec 2010 14:05:03 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PY1RD-000549-PV for submit@debbugs.gnu.org; Wed, 29 Dec 2010 14:11:56 -0500 Original-Received: from lists.gnu.org ([199.232.76.165]:34503) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PY1RD-000542-ML for submit@debbugs.gnu.org; Wed, 29 Dec 2010 14:11:55 -0500 Original-Received: from [140.186.70.92] (port=38261 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PY1RC-0002kS-52 for bug-gnu-emacs@gnu.org; Wed, 29 Dec 2010 14:11:55 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PY1RA-00052t-Nm for bug-gnu-emacs@gnu.org; Wed, 29 Dec 2010 14:11:54 -0500 Original-Received: from rcsinet10.oracle.com ([148.87.113.121]:17606) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PY1RA-00052M-Ic for bug-gnu-emacs@gnu.org; Wed, 29 Dec 2010 14:11:52 -0500 Original-Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id oBTJBnpA026198 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 29 Dec 2010 19:11:51 GMT Original-Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154]) by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id oBTIRp62029192 for ; Wed, 29 Dec 2010 19:11:49 GMT Original-Received: from abhmt009.oracle.com by acsmt354.oracle.com with ESMTP id 914442641293649827; Wed, 29 Dec 2010 11:10:27 -0800 Original-Received: from dradamslap1 (/10.159.216.195) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 29 Dec 2010 11:10:26 -0800 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcunjA/CwHTFH9mnR+W3EPpDoNObMg== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5994 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Wed, 29 Dec 2010 14:06:01 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:42922 Archived-At: (defun dired-revert (&optional arg noconfirm) "Reread the dired buffer. Must also be called after `dired-actual-switches' have changed. Should not fail even on completely garbaged buffers. Preserves old cursor, marks/flags, hidden-p." ...) The doc string should say that there are two optionl arguments and they are never used. And it should say explicitly that this is because this function is used as a value of `revert-buffer-function'. The last part is important - users should be able to see the connection easily. And it would be better to name the args for this function IGNORE1 and IGNORE2 or some such. In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600) of 2010-12-20 on 3249CTO Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.4) --no-opt --cflags -Ic:/imagesupport/include'