From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: Documentation style Date: Sat, 16 Oct 2004 09:52:42 -0400 Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Message-ID: References: <87y8i8t03j.fsf@oak.pohoyda.family> <200410151840.i9FIeit09642@raven.dms.auburn.edu> Reply-To: rms@gnu.org NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1097934881 4213 80.91.229.6 (16 Oct 2004 13:54:41 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 16 Oct 2004 13:54:41 +0000 (UTC) Cc: teirllm@dms.auburn.edu, alexander.pohoyda@gmx.net, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Oct 16 15:54:36 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 1CIp11-0006la-00 for ; Sat, 16 Oct 2004 15:54:35 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CIp8D-0007jL-KJ for ged-emacs-devel@m.gmane.org; Sat, 16 Oct 2004 10:02:01 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1CIp6n-00070O-2T for emacs-devel@gnu.org; Sat, 16 Oct 2004 10:00:33 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1CIp6k-0006yV-Iw for emacs-devel@gnu.org; Sat, 16 Oct 2004 10:00:30 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CIp6k-0006xo-Cg for emacs-devel@gnu.org; Sat, 16 Oct 2004 10:00:30 -0400 Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.34) id 1CIozC-0006QS-TC for emacs-devel@gnu.org; Sat, 16 Oct 2004 09:52:42 -0400 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.34) id 1CIozC-00033w-0W; Sat, 16 Oct 2004 09:52:42 -0400 Original-To: Stefan Monnier In-reply-to: (message from Stefan Monnier on Fri, 15 Oct 2004 15:40:33 -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: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:28478 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:28478 I've always disliked this kludge. We should probably strip make-docfile.c of all the elisp handling and instead we should fill the DOC while dumping Emacs (i.e. functions like `defun' and `autoload' should add the docstring to the DOC file), so the recognition of docstrings and their replacement by a reference to the DOC file are done at the same place and are thus known to be correct. This would not make things any better for users. I would rather see progress on things that will provide a benefit to the users. Meanwhile, for right now what we should focus on readying a new release.