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#7111: 24.0.50; `diff' argument order and doc string Date: Sun, 26 Sep 2010 10:18:47 -0700 Message-ID: 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 1285522890 12771 80.91.229.12 (26 Sep 2010 17:41:30 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 26 Sep 2010 17:41:30 +0000 (UTC) To: 7111@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Sep 26 19:41:29 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 1OzvE4-0001O3-7U for geb-bug-gnu-emacs@m.gmane.org; Sun, 26 Sep 2010 19:41:24 +0200 Original-Received: from localhost ([127.0.0.1]:37645 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OzvE3-0003bW-A8 for geb-bug-gnu-emacs@m.gmane.org; Sun, 26 Sep 2010 13:41:23 -0400 Original-Received: from [140.186.70.92] (port=41852 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OzvDu-0003Z9-H9 for bug-gnu-emacs@gnu.org; Sun, 26 Sep 2010 13:41:15 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OzvDt-0007mg-4c for bug-gnu-emacs@gnu.org; Sun, 26 Sep 2010 13:41:14 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:50564) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OzvDt-0007mc-3L for bug-gnu-emacs@gnu.org; Sun, 26 Sep 2010 13:41:13 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1OzuqU-0005aq-P6; Sun, 26 Sep 2010 13:17:02 -0400 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: Sun, 26 Sep 2010 17:17:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 7111 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.128552137221484 (code B ref -1); Sun, 26 Sep 2010 17:17:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 26 Sep 2010 17:16:12 +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 1Ozupf-0005aT-Or for submit@debbugs.gnu.org; Sun, 26 Sep 2010 13:16:12 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Ozupd-0005aO-S0 for submit@debbugs.gnu.org; Sun, 26 Sep 2010 13:16:10 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OzusI-0004O6-O7 for submit@debbugs.gnu.org; Sun, 26 Sep 2010 13:18:55 -0400 Original-Received: from lists.gnu.org ([199.232.76.165]:34810) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OzusI-0004O2-LB for submit@debbugs.gnu.org; Sun, 26 Sep 2010 13:18:54 -0400 Original-Received: from [140.186.70.92] (port=49261 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OzusH-0004UC-EC for bug-gnu-emacs@gnu.org; Sun, 26 Sep 2010 13:18:54 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OzusG-0004NQ-Bt for bug-gnu-emacs@gnu.org; Sun, 26 Sep 2010 13:18:53 -0400 Original-Received: from rcsinet10.oracle.com ([148.87.113.121]:31102) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OzusG-0004Mg-6z for bug-gnu-emacs@gnu.org; Sun, 26 Sep 2010 13:18:52 -0400 Original-Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id o8QHIlTk029213 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sun, 26 Sep 2010 17:18:49 GMT Original-Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154]) by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id o8QDTmve006949 for ; Sun, 26 Sep 2010 17:18:47 GMT Original-Received: from abhmt017.oracle.com by acsmt355.oracle.com with ESMTP id 630959591285521523; Sun, 26 Sep 2010 10:18:43 -0700 Original-Received: from dradamslap1 (/10.159.222.156) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 26 Sep 2010 10:18:43 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: ActdnuDxkju40fErQgyx6JYagt7PRA== 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, seldom 2.4 (older, 4) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sun, 26 Sep 2010 13:17:02 -0400 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:40465 Archived-At: emacs -Q C-h f diff The order that the file names are read is NEW, then OLD. The doc string describes them in the order OLD, then NEW, which is per Emacs doc convention: describe parameters in their order of appearance. But this can be confusing for a user. The params can be described in that order in the first line, but when speaking about reading them interactively it would be better to mention the read order explicitly: Instead of this: "When called interactively, read OLD and NEW using the minibuffer; the default for NEW is the current buffer's file name, and the default for OLD is a backup file for NEW, if one exists." Use something like this: "When called interactively, read NEW, then OLD, using the minibuffer. ^^^^^^^^^^^^^^^^^^^ The default for NEW is the current buffer's file name, and the default for OLD is a backup file for NEW, if one exists." The doc string already describes NEW before OLD when it comes to the default value. Better to say that NEW is read before OLD. And better to split the compound sentence in two. In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600) of 2010-09-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'