From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Phil Sainty Newsgroups: gmane.emacs.bugs Subject: bug#38575: 27.0.50; Document that `diff' arguments OLD and NEW can be buffers Date: Thu, 12 Dec 2019 19:46:40 +1300 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="64339"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Orcon Webmail To: 38575@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Dec 12 07:47:17 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.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1ifIFo-000GcK-NJ for geb-bug-gnu-emacs@m.gmane.org; Thu, 12 Dec 2019 07:47:16 +0100 Original-Received: from localhost ([::1]:55174 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ifIFm-0006DU-RU for geb-bug-gnu-emacs@m.gmane.org; Thu, 12 Dec 2019 01:47:14 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:58309) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ifIFb-0006DD-Jz for bug-gnu-emacs@gnu.org; Thu, 12 Dec 2019 01:47:04 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ifIFa-0006lE-4Z for bug-gnu-emacs@gnu.org; Thu, 12 Dec 2019 01:47:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:52984) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1ifIFZ-0006kg-SK for bug-gnu-emacs@gnu.org; Thu, 12 Dec 2019 01:47:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ifIFZ-0001lY-QV for bug-gnu-emacs@gnu.org; Thu, 12 Dec 2019 01:47:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Phil Sainty Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 12 Dec 2019 06:47:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 38575 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.15761332116770 (code B ref -1); Thu, 12 Dec 2019 06:47:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 12 Dec 2019 06:46:51 +0000 Original-Received: from localhost ([127.0.0.1]:58957 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ifIFO-0001l7-OT for submit@debbugs.gnu.org; Thu, 12 Dec 2019 01:46:50 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:33661) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ifIFM-0001l0-Uo for submit@debbugs.gnu.org; Thu, 12 Dec 2019 01:46:49 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:56530) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ifIFL-0006A0-Ks for bug-gnu-emacs@gnu.org; Thu, 12 Dec 2019 01:46:48 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ifIFK-0006Qw-Dc for bug-gnu-emacs@gnu.org; Thu, 12 Dec 2019 01:46:47 -0500 Original-Received: from smtp-2.orcon.net.nz ([60.234.4.43]:35065) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1ifIFK-0006Lc-3K for bug-gnu-emacs@gnu.org; Thu, 12 Dec 2019 01:46:46 -0500 Original-Received: from [10.253.37.70] (port=43924 helo=webmail.orcon.net.nz) by smtp-2.orcon.net.nz with esmtpa (Exim 4.90_1) (envelope-from ) id 1ifIFD-000364-Pc for bug-gnu-emacs@gnu.org; Thu, 12 Dec 2019 19:46:39 +1300 Original-Received: from wlgwil-nat-office.catalyst.net.nz ([202.78.240.7]) via [10.253.37.253] by webmail.orcon.net.nz with HTTP (HTTP/1.1 POST); Thu, 12 Dec 2019 19:46:40 +1300 X-Sender: psainty@orcon.net.nz X-GeoIP: -- X-Spam_score: -2.9 X-Spam_score_int: -28 X-Spam_bar: -- X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] 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:173208 Archived-At: The docstring for `diff' is: (diff OLD NEW &optional SWITCHES NO-ASYNC) Find and display the differences between OLD and NEW files. 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. If NO-ASYNC is non-nil, call diff synchronously. When called interactively with a prefix argument, prompt interactively for diff switches. Otherwise, the switches specified in the variable ‘diff-switches’ are passed to the diff command. However either (or both) of OLD and NEW may alternatively be buffers, with temporary files automatically created as necessary. This happens via `diff-file-local-copy' called by `diff-no-select'. This feature is utilised by `diff-buffer-with-file', and is far too useful to be undocumented by `diff'. I suggest the following additional paragraph: Non-interactively, OLD and NEW may each be buffers, in which case a temporary file will be used. If that wording is ok, I can commit the change. -Phil