From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Glenn Morris Newsgroups: gmane.emacs.devel Subject: the README file Date: Mon, 27 Nov 2006 23:34:12 -0500 Message-ID: NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1164688582 30901 80.91.229.2 (28 Nov 2006 04:36:22 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Tue, 28 Nov 2006 04:36:22 +0000 (UTC) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Nov 28 05:36:20 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 1Gouhe-0002gS-Rh for ged-emacs-devel@m.gmane.org; Tue, 28 Nov 2006 05:36:19 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Gouhe-000102-EE for ged-emacs-devel@m.gmane.org; Mon, 27 Nov 2006 23:36:18 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Gouff-0007nM-Km for emacs-devel@gnu.org; Mon, 27 Nov 2006 23:34:15 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Goufd-0007lR-Sw for emacs-devel@gnu.org; Mon, 27 Nov 2006 23:34:14 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Goufd-0007kv-7e for emacs-devel@gnu.org; Mon, 27 Nov 2006 23:34:13 -0500 Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.52) id 1Goufd-00065O-B2 for emacs-devel@gnu.org; Mon, 27 Nov 2006 23:34:13 -0500 Original-Received: from localhost ([127.0.0.1]) by fencepost.gnu.org with esmtp (Exim 4.52) id 1Goufc-0002RO-Dd; Mon, 27 Nov 2006 23:34:12 -0500 Original-To: emacs-devel@gnu.org X-Spook: offensive information warfare INSCOM Panama bullion Nazi X-Ran: mRI$Rc&/v"^KxVa^%0V9w[q~p9du)EyvwDzJ(!Y~#8Kzn.Zr=2-5l}5^8xTA>O97r4`z4; X-Hue: black X-Attribution: GM User-Agent: Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/) 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:62906 Archived-At: Obviously not hugely important, but normally when I download a package source, the README file is the first thing I read (being an obedient sort). The Emacs README could be improved IMO: Paragraphs 2 and 5 both describe how to report bugs. They could be merged. The wording of paragraph 4 seems a little bizarre to me ("bring up", "loaded the entire subtree"). The paragraph about configure seems superfluous, given that it is explained more nicely in the first paragraph of INSTALL. The paragraphs about `configure.in' and `Makefile.in': not something most people ever need to know, therefore does not really need to go in README. Move to INSTALL? The section on VMS: information about a version of Emacs 19 that runs on VMS can surely be removed now? In fact, can't all the information about VMS be moved to vms/README?