From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Chong Yidong Newsgroups: gmane.emacs.devel Subject: Re: Updating manuals Date: Sat, 18 Oct 2008 22:45:13 -0400 Message-ID: <87d4hxxpza.fsf@cyd.mit.edu> References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1224384324 29211 80.91.229.12 (19 Oct 2008 02:45:24 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 19 Oct 2008 02:45:24 +0000 (UTC) Cc: emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Oct 19 04:46:29 2008 connect(): Connection refused 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 1KrOJJ-00056P-CG for ged-emacs-devel@m.gmane.org; Sun, 19 Oct 2008 04:46:29 +0200 Original-Received: from localhost ([127.0.0.1]:60489 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KrOIE-0000oq-1q for ged-emacs-devel@m.gmane.org; Sat, 18 Oct 2008 22:45:22 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1KrOI9-0000ol-21 for emacs-devel@gnu.org; Sat, 18 Oct 2008 22:45:17 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1KrOI6-0000oZ-Ju for emacs-devel@gnu.org; Sat, 18 Oct 2008 22:45:15 -0400 Original-Received: from [199.232.76.173] (port=37901 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KrOI6-0000oW-FR for emacs-devel@gnu.org; Sat, 18 Oct 2008 22:45:14 -0400 Original-Received: from cyd.mit.edu ([18.115.2.24]:57582) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1KrOI5-0008BM-Bw; Sat, 18 Oct 2008 22:45:13 -0400 Original-Received: by cyd.mit.edu (Postfix, from userid 1000) id 7FDC257E195; Sat, 18 Oct 2008 22:45:13 -0400 (EDT) In-Reply-To: (Eli Zaretskii's message of "Sat, 18 Oct 2008 22:12:58 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (gnu/linux) X-detected-operating-system: by monty-python.gnu.org: Genre and OS details not recognized. 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:104621 Archived-At: Eli Zaretskii writes: > Judging by the rather small progress I made during these 5 days (30 > NEWS entries, with about 120 entries more remaining, including those > describing internationalization and multi-tty, which will require a > _really_ serious effort), I am now quite sure we are in trouble with > the prospective schedule of the pretest and release, unless much more > people will come on board to work on updating the manuals. (I could > only invest this many hours because it's a public holiday down here, > and it's almost over.) Thanks for taking the time to work on this. A couple of people have stepped forward to volunteer for various jobs. They are handling the documentation for the new font handling and the new display-buffer behavior. Hopefully, more will step up to the plate. > Having invested now 5 days in updating the ELisp manual, I'm quite > sure we should request that each code contribution be accompanied with > some meaningful documentation, even if it's not valid Texinfo. Yes. In the past, RMS spent quite a bit of time writing the documentation himself. In the future, we'll have to be more rigorous about requiring documentation with code changes.