From unknown Sat Sep 06 00:52:51 2025 X-Loop: owner@emacsbugs.donarmstrong.com Subject: bug#3036: 23.0.91; Manual doesn't mention diff-buffer-with-file Reply-To: Magnus Henoch , 3036@debbugs.gnu.org Resent-From: Magnus Henoch Resent-To: bug-submit-list@lists.donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Fri, 17 Apr 2009 21:40:09 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-Emacs-PR-Message: report 3036 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Received: via spool by submit@emacsbugs.donarmstrong.com id=B.124000388718905 (code B ref -1); Fri, 17 Apr 2009 21:40:09 +0000 Received: (at submit) by emacsbugs.donarmstrong.com; 17 Apr 2009 21:31:27 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: * X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=1.1 required=4.0 tests=FOURLA,IMPRONONCABLE_2 autolearn=no version=3.2.5-bugs.debian.org_2005_01_02 Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n3HLVDUY018864 for ; Fri, 17 Apr 2009 14:31:24 -0700 Received: from mail.gnu.org ([199.232.76.166]:52740 helo=mx10.gnu.org) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1LurjZ-0006LP-Vx for emacs-pretest-bug@gnu.org; Fri, 17 Apr 2009 13:20:14 -0400 Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1LurjU-000421-EG for emacs-pretest-bug@gnu.org; Fri, 17 Apr 2009 13:20:11 -0400 Received: from zimbra.erlangsystems.com ([88.208.247.62]:41080) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1LurjU-00041j-05 for emacs-pretest-bug@gnu.org; Fri, 17 Apr 2009 13:20:08 -0400 Received: from linux-b2a3.site (host213-123-170-251.in-addr.btopenworld.com [213.123.170.251]) by zimbra.erlangsystems.com (Postfix) with ESMTP id 6034F135A8A0 for ; Fri, 17 Apr 2009 18:18:01 +0100 (BST) From: Magnus Henoch To: emacs-pretest-bug@gnu.org X-Hashcash: 1:25:090417:emacs-pretest-bug@gnu.org::eRG5Wyz9RmT7blpL:000000000000000000000000000000000001embZ Date: Fri, 17 Apr 2009 18:20:02 +0100 Message-ID: <848wlz8af1.fsf@linux-b2a3.site> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.91 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) I recently needed M-x diff-buffer-with-file, but I didn't know what it was called, or even whether it existed. I couldn't find anything in the manual, despite looking at the "Comparing files" section. I propose something like the following: (feel free to improve wording) diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi index aad2b4a..c332018 100644 --- a/doc/emacs/files.texi +++ b/doc/emacs/files.texi @@ -1276,6 +1276,11 @@ most recent backup. If you specify the name of a backup file, @code{diff-backup} compares it with the source file that it is a backup of. In all other respects, this behaves like @kbd{M-x diff}. +@findex diff-buffer-with-file + The command @kbd{M-x diff-buffer-with-file} compares the a buffer +with its corresponding file, in effect displaying what you would +change if you would save the buffer. + @findex compare-windows The command @kbd{M-x compare-windows} compares the text in the current window with that in the next window. (For more information If Emacs crashed, and you have the Emacs process in the gdb debugger, please include the output from the following gdb commands: `bt full' and `xbacktrace'. If you would like to further debug the crash, please read the file /usr/local/share/emacs/23.0.91/etc/DEBUG for instructions. In GNU Emacs 23.0.91.1 (i686-pc-linux-gnu, GTK+ Version 2.14.4) of 2009-03-02 on linux-b2a3 Windowing system distributor `The X.Org Foundation', version 11.0.10502000 Important settings: value of $LC_ALL: nil value of $LC_COLLATE: C value of $LC_CTYPE: nil value of $LC_MESSAGES: nil value of $LC_MONETARY: nil value of $LC_NUMERIC: nil value of $LC_TIME: nil value of $LANG: en_US.UTF-8 value of $XMODIFIERS: @im=local locale-coding-system: utf-8-unix default-enable-multibyte-characters: t Major mode: Diff Minor modes in effect: diff-auto-refine-mode: t shell-dirtrack-mode: t jabber-activity-mode: t jabber-mode-line-mode: t show-paren-mode: t server-mode: t icomplete-mode: t display-time-mode: t tooltip-mode: t mouse-wheel-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t blink-cursor-mode: t global-auto-composition-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t line-number-mode: t transient-mark-mode: t Recent input: M-! l a s t C-x C-j C-l C-x b * G g C-x b C o m f i l e C-o @ f i n d e x SPC d i f f - b u f f e r - w i t h - f i l e SPC SPC T h e SPC c o m m a n d SPC @ k b d { M - x SPC d i f - f - b u f f e r - w i t h - f i l e } SPC c o m p a r e s SPC C-c a M-x a u t o - i f f i l l t h e SPC c o n t e n t s SPC o f SPC a SPC b u C-a C-d C-d C-e f f e r SPC w i t h SPC t h e SPC M-b M-b M-b M-b M-q i t s SPC c o r r e s p o n d i n g SPC f i l e , SPC i n SPC e f f e c t SPC d i s p l a y i n g SPC w h a t SPC y o u SPC w o u l d SPC c h a n g e SPC i f SPC y o u SPC w o u l d SPC s a v e SPC t h e SPC b u f f e r . C-x C-s C-x v = M-x r e p o r t - Recent messages: nnimap: Checking mailboxes...done Reading active file from news.gmane.org via nntp... Reading active file from archive via nnfolder...done Checking new news... Opening nndoc server on gnus-help...done Checking new news...done Saving file /home/magnus/src/emacs/doc/emacs/files.texi... Wrote /home/magnus/src/emacs/doc/emacs/files.texi Finding changes in /home/magnus/src/emacs/doc/emacs/files.texi...done From unknown Sat Sep 06 00:52:51 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.420 (Entity 5.420) X-Loop: owner@emacsbugs.donarmstrong.com From: help-debbugs@gnu.org (Emacs bug Tracking System) To: Magnus Henoch Subject: bug#3036 closed by Chong Yidong (Re: 23.0.91; Manual doesn't mention diff-buffer-with-file) Message-ID: References: <87d4bawx89.fsf@cyd.mit.edu> <848wlz8af1.fsf@linux-b2a3.site> X-Emacs-PR-Message: they-closed 3036 X-Emacs-PR-Package: emacs Reply-To: 3036@debbugs.gnu.org Date: Sat, 18 Apr 2009 01:50:04 +0000 Content-Type: multipart/mixed; boundary="----------=_1240019404-26995-1" This is a multi-part message in MIME format... ------------=_1240019404-26995-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" This is an automatic notification regarding your bug report which was filed against the emacs package: #3036: 23.0.91; Manual doesn't mention diff-buffer-with-file It has been closed by Chong Yidong . Their explanation is attached below along with your original report. If this explanation is unsatisfactory and you have not received a better one in a separate message then please contact Chong Yidong by replying to this email. --=20 3036: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D3036 Emacs Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1240019404-26995-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 3036-done) by emacsbugs.donarmstrong.com; 18 Apr 2009 01:43:55 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=0.0 required=4.0 tests=none autolearn=ham version=3.2.5-bugs.debian.org_2005_01_02 Received: from cyd.mit.edu (CYD.MIT.EDU [18.115.2.24]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n3I1hqNn025593 for <3036-done@emacsbugs.donarmstrong.com>; Fri, 17 Apr 2009 18:43:53 -0700 Received: by cyd.mit.edu (Postfix, from userid 1000) id A65D357E21C; Fri, 17 Apr 2009 21:45:42 -0400 (EDT) From: Chong Yidong To: Magnus Henoch Cc: 3036-done@debbugs.gnu.org Subject: Re: 23.0.91; Manual doesn't mention diff-buffer-with-file Date: Fri, 17 Apr 2009 21:45:42 -0400 Message-ID: <87d4bawx89.fsf@cyd.mit.edu> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii > I recently needed M-x diff-buffer-with-file, but I didn't know what it > was called, or even whether it existed. I couldn't find anything in > the manual, despite looking at the "Comparing files" section. I > propose something like the following: (feel free to improve wording) Thanks for the suggestion. I've checked in something similar. ------------=_1240019404-26995-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by emacsbugs.donarmstrong.com; 17 Apr 2009 21:31:27 +0000 X-Spam-Checker-Version: SpamAssassin 3.2.5-bugs.debian.org_2005_01_02 (2008-06-10) on rzlab.ucr.edu X-Spam-Level: * X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. X-Spam-Status: No, score=1.1 required=4.0 tests=FOURLA,IMPRONONCABLE_2 autolearn=no version=3.2.5-bugs.debian.org_2005_01_02 Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n3HLVDUY018864 for ; Fri, 17 Apr 2009 14:31:24 -0700 Received: from mail.gnu.org ([199.232.76.166]:52740 helo=mx10.gnu.org) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1LurjZ-0006LP-Vx for emacs-pretest-bug@gnu.org; Fri, 17 Apr 2009 13:20:14 -0400 Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1LurjU-000421-EG for emacs-pretest-bug@gnu.org; Fri, 17 Apr 2009 13:20:11 -0400 Received: from zimbra.erlangsystems.com ([88.208.247.62]:41080) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1LurjU-00041j-05 for emacs-pretest-bug@gnu.org; Fri, 17 Apr 2009 13:20:08 -0400 Received: from linux-b2a3.site (host213-123-170-251.in-addr.btopenworld.com [213.123.170.251]) by zimbra.erlangsystems.com (Postfix) with ESMTP id 6034F135A8A0 for ; Fri, 17 Apr 2009 18:18:01 +0100 (BST) From: Magnus Henoch To: emacs-pretest-bug@gnu.org Subject: 23.0.91; Manual doesn't mention diff-buffer-with-file X-Hashcash: 1:25:090417:emacs-pretest-bug@gnu.org::eRG5Wyz9RmT7blpL:000000000000000000000000000000000001embZ Date: Fri, 17 Apr 2009 18:20:02 +0100 Message-ID: <848wlz8af1.fsf@linux-b2a3.site> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.91 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) I recently needed M-x diff-buffer-with-file, but I didn't know what it was called, or even whether it existed. I couldn't find anything in the manual, despite looking at the "Comparing files" section. I propose something like the following: (feel free to improve wording) diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi index aad2b4a..c332018 100644 --- a/doc/emacs/files.texi +++ b/doc/emacs/files.texi @@ -1276,6 +1276,11 @@ most recent backup. If you specify the name of a backup file, @code{diff-backup} compares it with the source file that it is a backup of. In all other respects, this behaves like @kbd{M-x diff}. +@findex diff-buffer-with-file + The command @kbd{M-x diff-buffer-with-file} compares the a buffer +with its corresponding file, in effect displaying what you would +change if you would save the buffer. + @findex compare-windows The command @kbd{M-x compare-windows} compares the text in the current window with that in the next window. (For more information If Emacs crashed, and you have the Emacs process in the gdb debugger, please include the output from the following gdb commands: `bt full' and `xbacktrace'. If you would like to further debug the crash, please read the file /usr/local/share/emacs/23.0.91/etc/DEBUG for instructions. In GNU Emacs 23.0.91.1 (i686-pc-linux-gnu, GTK+ Version 2.14.4) of 2009-03-02 on linux-b2a3 Windowing system distributor `The X.Org Foundation', version 11.0.10502000 Important settings: value of $LC_ALL: nil value of $LC_COLLATE: C value of $LC_CTYPE: nil value of $LC_MESSAGES: nil value of $LC_MONETARY: nil value of $LC_NUMERIC: nil value of $LC_TIME: nil value of $LANG: en_US.UTF-8 value of $XMODIFIERS: @im=local locale-coding-system: utf-8-unix default-enable-multibyte-characters: t Major mode: Diff Minor modes in effect: diff-auto-refine-mode: t shell-dirtrack-mode: t jabber-activity-mode: t jabber-mode-line-mode: t show-paren-mode: t server-mode: t icomplete-mode: t display-time-mode: t tooltip-mode: t mouse-wheel-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t blink-cursor-mode: t global-auto-composition-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t line-number-mode: t transient-mark-mode: t Recent input: M-! l a s t C-x C-j C-l C-x b * G g C-x b C o m f i l e C-o @ f i n d e x SPC d i f f - b u f f e r - w i t h - f i l e SPC SPC T h e SPC c o m m a n d SPC @ k b d { M - x SPC d i f - f - b u f f e r - w i t h - f i l e } SPC c o m p a r e s SPC C-c a M-x a u t o - i f f i l l t h e SPC c o n t e n t s SPC o f SPC a SPC b u C-a C-d C-d C-e f f e r SPC w i t h SPC t h e SPC M-b M-b M-b M-b M-q i t s SPC c o r r e s p o n d i n g SPC f i l e , SPC i n SPC e f f e c t SPC d i s p l a y i n g SPC w h a t SPC y o u SPC w o u l d SPC c h a n g e SPC i f SPC y o u SPC w o u l d SPC s a v e SPC t h e SPC b u f f e r . C-x C-s C-x v = M-x r e p o r t - Recent messages: nnimap: Checking mailboxes...done Reading active file from news.gmane.org via nntp... Reading active file from archive via nnfolder...done Checking new news... Opening nndoc server on gnus-help...done Checking new news...done Saving file /home/magnus/src/emacs/doc/emacs/files.texi... Wrote /home/magnus/src/emacs/doc/emacs/files.texi Finding changes in /home/magnus/src/emacs/doc/emacs/files.texi...done ------------=_1240019404-26995-1--