From mboxrd@z Thu Jan  1 00:00:00 1970
Path: main.gmane.org!not-for-mail
From: Richard Stallman <rms@gnu.org>
Newsgroups: gmane.emacs.devel
Subject: Re: doc elisp intro cross reference fixes
Date: Fri, 28 Nov 2003 18:14:11 -0500
Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org
Message-ID: <E1AProR-000470-5m@fencepost.gnu.org>
References: <87wua28zux.fsf@zip.com.au> <87ad6vdsxi.fsf@mail.jurta.org>
	<m1ALpj6-000UNaC@rattlesnake.com> <E1AMEt7-0000Bu-Jg@fencepost.gnu.org>
	<jwvk75x12i3.fsf-monnier+emacs/devel@vor.iro.umontreal.ca>
	<rjvfp7uhv6.fsf@sheridan.dina.kvl.dk> <87y8u2uv6l.fsf@mail.jurta.org>
	<rjk75m3w3h.fsf@sheridan.dina.kvl.dk>
Reply-To: rms@gnu.org
NNTP-Posting-Host: deer.gmane.org
X-Trace: sea.gmane.org 1070061948 29046 80.91.224.253 (28 Nov 2003 23:25:48 GMT)
X-Complaints-To: usenet@sea.gmane.org
NNTP-Posting-Date: Fri, 28 Nov 2003 23:25:48 +0000 (UTC)
Cc: emacs-devel@gnu.org
Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Sat Nov 29 00:25:46 2003
Return-path: <emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org>
Original-Received: from quimby.gnus.org ([80.91.224.244])
	by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian))
	id 1APrze-0007W5-00
	for <emacs-devel@deer.gmane.org>; Sat, 29 Nov 2003 00:25:46 +0100
Original-Received: from monty-python.gnu.org ([199.232.76.173])
	by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian))
	id 1APrzd-0003vL-00
	for <emacs-devel@quimby.gnus.org>; Sat, 29 Nov 2003 00:25:46 +0100
Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org)
	by monty-python.gnu.org with esmtp (Exim 4.24)
	id 1APswE-0001yZ-Lj
	for emacs-devel@quimby.gnus.org; Fri, 28 Nov 2003 19:26:18 -0500
Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.24)
	id 1APsvY-0001qb-Dx
	for emacs-devel@gnu.org; Fri, 28 Nov 2003 19:25:36 -0500
Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.24)
	id 1APsv1-0001fa-Dp
	for emacs-devel@gnu.org; Fri, 28 Nov 2003 19:25:34 -0500
Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org)
	by monty-python.gnu.org with esmtp (Exim 4.24) id 1APsv0-0001fR-Rd
	for emacs-devel@gnu.org; Fri, 28 Nov 2003 19:25:02 -0500
Original-Received: from rms by fencepost.gnu.org with local (Exim 4.24)
	id 1AProR-000470-5m; Fri, 28 Nov 2003 18:14:11 -0500
Original-To: Per Abrahamsen <abraham@dina.kvl.dk>
In-reply-to: <rjk75m3w3h.fsf@sheridan.dina.kvl.dk> (message from Per
	Abrahamsen on Thu, 27 Nov 2003 12:10:58 +0100)
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.1.2
Precedence: list
List-Id: Emacs development discussions.  <emacs-devel.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/emacs-devel>
List-Post: <mailto:emacs-devel@gnu.org>
List-Help: <mailto:emacs-devel-request@gnu.org?subject=help>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=subscribe>
Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org
Xref: main.gmane.org gmane.emacs.devel:18194
X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:18194

    It used to be true back when doc-strings were dumped into the
    executable and memory was scarce.  

Exactly.  We wrote comments instead of doc strings for internal
functions and variables.

    But I believe doc-strings for internal variables and functions are
    considered acceptable these days.

That's correct.  Nowadays, we may as well make these comments into doc
strings.  They are easier to find that way, and it does no harm.