From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Magnus Henoch Newsgroups: gmane.emacs.bugs,gmane.emacs.pretest.bugs Subject: bug#3036: 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> Reply-To: Magnus Henoch , 3036@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1240005024 16903 80.91.229.12 (17 Apr 2009 21:50:24 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 17 Apr 2009 21:50:24 +0000 (UTC) To: emacs-pretest-bug@gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Apr 17 23:51:43 2009 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.50) id 1LuvyG-0000Do-11 for geb-bug-gnu-emacs@m.gmane.org; Fri, 17 Apr 2009 23:51:40 +0200 Original-Received: from localhost ([127.0.0.1]:43340 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Luvwr-0007IC-7t for geb-bug-gnu-emacs@m.gmane.org; Fri, 17 Apr 2009 17:50:13 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Luvqt-0002oO-Iv for bug-gnu-emacs@gnu.org; Fri, 17 Apr 2009 17:44:03 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Luvqm-0002jo-PE for bug-gnu-emacs@gnu.org; Fri, 17 Apr 2009 17:44:01 -0400 Original-Received: from [199.232.76.173] (port=45111 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Luvqm-0002jR-IT for bug-gnu-emacs@gnu.org; Fri, 17 Apr 2009 17:43:56 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:60018) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Luvql-0005VH-TZ for bug-gnu-emacs@gnu.org; Fri, 17 Apr 2009 17:43:56 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n3HLhpxD021803; Fri, 17 Apr 2009 14:43:52 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id n3HLeAMb021028; Fri, 17 Apr 2009 14:40:10 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: Magnus Henoch Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Fri, 17 Apr 2009 21:40:09 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: report 3036 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.124000388718905 (code B ref -1); Fri, 17 Apr 2009 21:40:09 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 17 Apr 2009 21:31:27 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-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 Original-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 Original-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 Original-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 Original-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) X-Hashcash: 1:25:090417:emacs-pretest-bug@gnu.org::eRG5Wyz9RmT7blpL:000000000000000000000000000000000001embZ User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.91 (gnu/linux) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) Resent-Date: Fri, 17 Apr 2009 17:44:01 -0400 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list 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:27282 gmane.emacs.pretest.bugs:24300 Archived-At: 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