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: merging etc Date: Thu, 30 Aug 2007 23:58:26 +0300 Message-ID: References: <200708211523.l7LFNnVl000876@oogie-boogie.ics.uci.edu> <200708220820.l7M8KbIt026014@oogie-boogie.ics.uci.edu> <200708290403.l7T43TS6023420@oogie-boogie.ics.uci.edu> <200708290425.l7T4P4TC023875@oogie-boogie.ics.uci.edu> Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org X-Trace: sea.gmane.org 1188507676 30238 80.91.229.12 (30 Aug 2007 21:01:16 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 30 Aug 2007 21:01:16 +0000 (UTC) Cc: joakim@verona.se, emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Aug 30 23:01:12 2007 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1IQr8V-0004X1-PS for ged-emacs-devel@m.gmane.org; Thu, 30 Aug 2007 23:01:08 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IQr8U-00052L-W1 for ged-emacs-devel@m.gmane.org; Thu, 30 Aug 2007 17:01:07 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1IQr63-0001uq-QA for emacs-devel@gnu.org; Thu, 30 Aug 2007 16:58:35 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1IQr62-0001ti-Sd for emacs-devel@gnu.org; Thu, 30 Aug 2007 16:58:35 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IQr62-0001tO-Lv for emacs-devel@gnu.org; Thu, 30 Aug 2007 16:58:34 -0400 Original-Received: from romy.inter.net.il ([213.8.233.24]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1IQr62-0002X1-3W for emacs-devel@gnu.org; Thu, 30 Aug 2007 16:58:34 -0400 Original-Received: from HOME-C4E4A596F7 (IGLD-84-229-254-135.inter.net.il [84.229.254.135]) by romy.inter.net.il (MOS 3.7.3-GA) with ESMTP id ITR75235 (AUTH halo1); Thu, 30 Aug 2007 23:58:18 +0300 (IDT) In-reply-to: (message from Stefan Monnier on Thu, 30 Aug 2007 08:37:33 -0400) X-Detected-Kernel: FreeBSD 4.7-5.2 (or MacOS X 10.2-10.4) (2) 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:77437 Archived-At: > From: Stefan Monnier > Date: Thu, 30 Aug 2007 08:37:33 -0400 > Cc: emacs-devel > > > Just to get things started, here is a tentative NEWS entry: > > > ** Emacs now supports several simultaneous display devices. > > Emacs can now handle frames on several different X displays and > > terminals simultaneously. Emacsclient has also been extendend to allow > > specification on which display to use. > > That's the Emacs-level documentation. Actually, it isn't even that. It's basically an announcement of a new feature without any details, and as such, it's almost useless. Joakim, please take a moment to browse through NEWS entries. For each new feature, they mention at least the most important user commands and variables, and any other auxiliary info, like environment variables, that are necessary to at least turn on/off the feature and control its behavior in some basic ways. In CVS, this kind of documentation serves yet another purpose: it is a reminder to update the manual with the expanded version of the documentation. Without such a reminder, chances are we will forget to update the manual when the time comes to release Emacs. If neither the manual nor NEWS have some information about a new feature (and a major feature such as multi-tty), that feature does not exist for all practical purposes, since no one will be able to use it without prolonged study of the sources. Please have a mercy on us!