From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: read-file-name-predicate Date: Wed, 07 Mar 2007 18:49:45 +0200 Message-ID: References: Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org X-Trace: sea.gmane.org 1173286211 32631 80.91.229.12 (7 Mar 2007 16:50:11 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 7 Mar 2007 16:50:11 +0000 (UTC) Cc: emacs-devel@gnu.org To: "Drew Adams" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Mar 07 17:50:04 2007 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 1HOzL1-0005he-VT for ged-emacs-devel@m.gmane.org; Wed, 07 Mar 2007 17:50:04 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HOzL8-00070i-Fv for ged-emacs-devel@m.gmane.org; Wed, 07 Mar 2007 11:50:10 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1HOzKf-0006t1-Jm for emacs-devel@gnu.org; Wed, 07 Mar 2007 11:49:41 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1HOzKd-0006s3-Mt for emacs-devel@gnu.org; Wed, 07 Mar 2007 11:49:40 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HOzKd-0006rz-FP for emacs-devel@gnu.org; Wed, 07 Mar 2007 11:49:39 -0500 Original-Received: from nitzan.inter.net.il ([213.8.233.22]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1HOzKW-00018L-12 for emacs-devel@gnu.org; Wed, 07 Mar 2007 11:49:32 -0500 Original-Received: from HOME-C4E4A596F7 (IGLD-80-230-28-160.inter.net.il [80.230.28.160]) by nitzan.inter.net.il (MOS 3.7.3a-GA) with ESMTP id GFX88043 (AUTH halo1); Wed, 7 Mar 2007 18:49:28 +0200 (IST) In-reply-to: X-detected-kernel: FreeBSD 4.7-5.2 (or MacOS X 10.2-10.4) (2) 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:67511 Archived-At: > From: "Drew Adams" > Date: Wed, 7 Mar 2007 08:31:59 -0800 > > My point is that it is currently entre deux chaises. Either 1) it should be, as it is, accessible from Lisp, in which case it should be documented, or 2) it should be inaccessible from Lisp. (Yes, I do realize that not everything that is accessible from Lisp is documented.) There are internal functions written in Lisp and internal Lisp variables. They are frequently not documented too well because it is frequently hard to document them without explaining a lot of Emacs internals. This is perfectly normal. 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).