From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!not-for-mail
From: Richard Stallman <rms@gnu.org>
Newsgroups: gmane.emacs.devel
Subject: Re: read-file-name-predicate
Date: Wed, 07 Mar 2007 22:16:28 -0500
Message-ID: <E1HP97E-00088b-R4@fencepost.gnu.org>
References: <EIENLHALHGIMHGDOLMIMGEJHCPAA.drew.adams@oracle.com>
	<ud53lngly.fsf@gnu.org>
Reply-To: rms@gnu.org
NNTP-Posting-Host: lo.gmane.org
Content-Type: text/plain; charset=ISO-8859-15
X-Trace: sea.gmane.org 1173323991 31257 80.91.229.12 (8 Mar 2007 03:19:51 GMT)
X-Complaints-To: usenet@sea.gmane.org
NNTP-Posting-Date: Thu, 8 Mar 2007 03:19:51 +0000 (UTC)
Cc: drew.adams@oracle.com, emacs-devel@gnu.org
To: Eli Zaretskii <eliz@gnu.org>
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Mar 08 04:19:40 2007
Return-path: <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>
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 1HP9AJ-0005Hs-QY
	for ged-emacs-devel@m.gmane.org; Thu, 08 Mar 2007 04:19:40 +0100
Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43)
	id 1HP9AT-0005JU-EC
	for ged-emacs-devel@m.gmane.org; Wed, 07 Mar 2007 22:19:49 -0500
Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43)
	id 1HP998-0004mp-Kc
	for emacs-devel@gnu.org; Wed, 07 Mar 2007 22:18:26 -0500
Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43)
	id 1HP997-0004mU-WB
	for emacs-devel@gnu.org; Wed, 07 Mar 2007 22:18:26 -0500
Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1HP997-0004mO-NS
	for emacs-devel@gnu.org; Wed, 07 Mar 2007 22:18:25 -0500
Original-Received: from fencepost.gnu.org ([199.232.76.164])
	by monty-python.gnu.org with esmtp (Exim 4.60)
	(envelope-from <rms@gnu.org>) id 1HP98x-0007ci-27
	for emacs-devel@gnu.org; Wed, 07 Mar 2007 22:18:15 -0500
Original-Received: from rms by fencepost.gnu.org with local (Exim 4.60)
	(envelope-from <rms@gnu.org>)
	id 1HP97E-00088b-R4; Wed, 07 Mar 2007 22:16:29 -0500
In-reply-to: <ud53lngly.fsf@gnu.org> (message from Eli Zaretskii on Wed, 07
	Mar 2007 18:49:45 +0200)
X-detected-kernel: Linux 2.6, seldom 2.4 (older, 4)
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: "Emacs development discussions." <emacs-devel.gnu.org>
List-Unsubscribe: <http://lists.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.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://lists.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=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:67552
Archived-At: <http://permalink.gmane.org/gmane.emacs.devel/67552>

    I don't know if in this specific case the variable is a left-over from
    something we don't need anymore; I hope Kim will answer that.  But
    your general point -- that Lisp variables should all be documented to
    the degree that every Emacs user should understand -- is not valid (as
    a generality).

That is correct.  Some C features need Lisp variables (and Lisp
primitive functions) that are internal and we do not need to document
them.  In some cases we do not WANT Lisp programmers to use these
internal functions and variables.