From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Luc Teirlinck Newsgroups: gmane.emacs.devel Subject: Re: Proof-reading manuals (was Re: Rmail mbox-format branch) Date: Tue, 14 Sep 2004 20:12:49 -0500 (CDT) Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Message-ID: <200409150112.i8F1CnL22210@raven.dms.auburn.edu> References: <41406C46.6050505@pajato.com> <01c4969e$Blat.v2.2.2$d48c9a40@zahav.net.il> <20040909221947.GB11694@fencepost> <200409110249.i8B2nah12319@raven.dms.auburn.edu> NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1095210861 15556 80.91.229.6 (15 Sep 2004 01:14:21 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 15 Sep 2004 01:14:21 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Sep 15 03:14:08 2004 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1C7ON6-0007r5-00 for ; Wed, 15 Sep 2004 03:14:08 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1C7OSh-0001Nk-Ek for ged-emacs-devel@m.gmane.org; Tue, 14 Sep 2004 21:19:55 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1C7OSZ-0001Ne-Lg for emacs-devel@gnu.org; Tue, 14 Sep 2004 21:19:47 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1C7OSY-0001NS-3z for emacs-devel@gnu.org; Tue, 14 Sep 2004 21:19:47 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1C7OSX-0001NP-Uy for emacs-devel@gnu.org; Tue, 14 Sep 2004 21:19:46 -0400 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.34) id 1C7OMW-0003Rs-Kv for emacs-devel@gnu.org; Tue, 14 Sep 2004 21:13:32 -0400 Original-Received: from raven.dms.auburn.edu (raven.dms.auburn.edu [131.204.53.29]) by manatee.dms.auburn.edu (8.12.10/8.12.10) with ESMTP id i8F1DLuE024095; Tue, 14 Sep 2004 20:13:21 -0500 (CDT) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.7p1+Sun/8.11.7) id i8F1CnL22210; Tue, 14 Sep 2004 20:12:49 -0500 (CDT) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: storm@cua.dk In-reply-to: (storm@cua.dk) 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: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:27116 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:27116 Kim Storm wrote: To help organize the process, I have added a list of all the relevant texi files in admin/FOR-RELEASE like this: DONE SECTION --------------------------------------------- man/abbrevs.texi For lispref this way of organizing things may be reasonable, but for man it makes no sense. It might be nice to have things like man/cl.texi updated, but such things are a luxury right now. What we worry about now is the Emacs and Elisp manual and info.texi. I proofread all of the Elisp manual except the chapters (if you do `C-h i elisp'): Advising Functions Debugging Customization Modes Text Processes Display Calendar I did also not check or update: Antinews GNU Free Documentation License GPL Standard Buffer-Local Variables Standard Keymaps Standard Hooks New Symbols However, I have read Text up to and including `(elisp)Maintaining Undo'. I _will_ read Customization because there still is some unfinished business there. I still need to go over some details in some of the sections I read, due to developments after I read them. For the Emacs manual, I read everything up to and including (in Info order), Info Chapter 29, Commands for Human Languages. (The "29" only makes sense if you are using texinfo 4.7.) However, I skipped `(emacs)HTML Mode' and `(emacs)Nroff Mode', because I never use the material in those sections (I do not know HTML, SGML, XML nor NROFF). I will still have to take a closer look at some sections I already read. Of course, the original aim was to have everything proofread by at least two persons, but that seems unrealistic now. Note that the reason why all of this takes time is not just the proofreading and correcting of the documentation. All kinds of bugs come to light during proofreading and they have to be corrected. Sincerely, Luc.