From unknown Sat Sep 06 00:52:54 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#3036 <3036@debbugs.gnu.org> To: bug#3036 <3036@debbugs.gnu.org> Subject: Status: 23.0.91; Manual doesn't mention diff-buffer-with-file Reply-To: bug#3036 <3036@debbugs.gnu.org> Date: Sat, 06 Sep 2025 07:52:54 +0000 retitle 3036 23.0.91; Manual doesn't mention diff-buffer-with-file reassign 3036 emacs submitter 3036 Magnus Henoch severity 3036 normal thanks From magnus@erlang-consulting.com Fri Apr 17 14:31:26 2009 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 From cyd@stupidchicken.com Fri Apr 17 18:43:55 2009 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. From unknown Sat Sep 06 00:52:54 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: $requester Subject: Internal Control Message-Id: bug archived. Date: Sat, 16 May 2009 14:24:07 +0000 User-Agent: Fakemail v42.6.9 # A New Hope # A log time ago, in a galaxy far, far away # something happened. # # Magically this resulted in the following # action being taken, but this fake control # message doesn't tell you why it happened # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator