bug#3036: marked as done (23.0.91; Manual doesn't mention diff-buffer-with-file)

[owner@emacsbugs.donarmstrong.com (Emacs bug Tracking System)]

[-- Attachment #1: Type: text/plain, Size: 892 bytes --]


Your message dated Fri, 17 Apr 2009 21:45:42 -0400
with message-id <87d4bawx89.fsf@cyd.mit.edu>
and subject line Re: 23.0.91; Manual doesn't mention diff-buffer-with-file
has caused the Emacs bug report #3036,
regarding 23.0.91; Manual doesn't mention diff-buffer-with-file
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@emacsbugs.donarmstrong.com
immediately.)


-- 
3036: http://emacsbugs.donarmstrong.com/cgi-bin/bugreport.cgi?bug=3036
Emacs Bug Tracking System
Contact owner@emacsbugs.donarmstrong.com with problems

[-- Attachment #2: Type: message/rfc822, Size: 5806 bytes --]

From: Magnus Henoch <mange@freemail.hu>
To: emacs-pretest-bug@gnu.org
Subject: 23.0.91; Manual doesn't mention diff-buffer-with-file
Date: Fri, 17 Apr 2009 18:20:02 +0100
Message-ID: <848wlz8af1.fsf@linux-b2a3.site>

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:
<down> <down> <down> <down> <down> <down> <down> M-! 
l a s t <return> C-x C-j C-l C-x b * G <return> g C-x 
b C o m <backspace> <backspace> <backspace> f i l e 
<return> C-o <return> @ 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 <return> SPC SPC T h 
e SPC c o m m a n d SPC @ k b d { M - x SPC d i f - 
<backspace> 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 <backspace> 
<backspace> f i l l <tab> <return> 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-backspace> 
<M-backspace> M-q <down> <M-backspace> 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 - <tab> <return>

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



[-- Attachment #3: Type: message/rfc822, Size: 1406 bytes --]

From: Chong Yidong <cyd@stupidchicken.com>
To: Magnus Henoch <mange@freemail.hu>
Cc: 3036-done@emacsbugs.donarmstrong.com
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>

> 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.