From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: emacs doc changes Date: Thu, 20 Apr 2006 12:50:33 +0300 Message-ID: References: <4nodz4ywgg.fsf@asimov.bwh.harvard.edu> <4nejzv9b98.fsf@asimov.bwh.harvard.edu> <4n7j5l5xt6.fsf_-_@asimov.bwh.harvard.edu> <85fyk9fnxv.fsf@lola.goethe.zz> <4nacah4f88.fsf@asimov.bwh.harvard.edu> <85bquxfn3j.fsf@lola.goethe.zz> <20060419183441.GA3137@gothmog.pc> Reply-To: Eli Zaretskii NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1145526664 22418 80.91.229.2 (20 Apr 2006 09:51:04 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 20 Apr 2006 09:51:04 +0000 (UTC) Cc: keramida@ceid.upatras.gr, tzz@lifelogs.com, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Apr 20 11:51:01 2006 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1FWVoJ-0002LT-8J for ged-emacs-devel@m.gmane.org; Thu, 20 Apr 2006 11:50:52 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FWVoI-0003l9-Qg for ged-emacs-devel@m.gmane.org; Thu, 20 Apr 2006 05:50:50 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1FWVo4-0003kH-Ct for emacs-devel@gnu.org; Thu, 20 Apr 2006 05:50:36 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1FWVo2-0003jq-O1 for emacs-devel@gnu.org; Thu, 20 Apr 2006 05:50:36 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FWVo2-0003jn-Lw for emacs-devel@gnu.org; Thu, 20 Apr 2006 05:50:34 -0400 Original-Received: from [192.114.186.66] (helo=romy.inter.net.il) by monty-python.gnu.org with esmtp (Exim 4.52) id 1FWVpL-0002TZ-7Z for emacs-devel@gnu.org; Thu, 20 Apr 2006 05:51:55 -0400 Original-Received: from HOME-C4E4A596F7 (IGLD-80-230-8-103.inter.net.il [80.230.8.103]) by romy.inter.net.il (MOS 3.7.3-GA) with ESMTP id DZX62649 (AUTH halo1); Thu, 20 Apr 2006 12:50:28 +0300 (IDT) Original-To: Stefan Monnier In-reply-to: (message from Stefan Monnier on Wed, 19 Apr 2006 16:44:43 -0400) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:53130 Archived-At: > From: Stefan Monnier > Date: Wed, 19 Apr 2006 16:44:43 -0400 > Cc: Ted Zlatanov , emacs-devel@gnu.org > > Let me also remind people that diff-mode.el provides diff-context->unified > and diff-unified->context commands. ``Remind us''? You mean, we were supposed to know that somehow? The manual says almost nothing about diff-mode, which IMHO is a shame, since it's a great time savior. For example, yesterday I found out (by sheer luck, simply because I typed a command in the wrong buffer) that "C-x 4 a" does TRT in the diffs buffer, i.e. looks up the hunk's function in the original file and generates a correct ChangeLog entry. This feature exists since Oct 2000, but all that NEWS has to say about diff-mode, since Emacs 21.1 until today, is this: *** diff-mode.el provides `diff-mode', a major mode for viewing/editing context diffs (patches). It is selected for files with extension `.diff', `.diffs', `.patch' and `.rej'. I think at least emacs-xtra.texi should include some decent documentation for a feature which any serious programmer should be using every day.