From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Lute Kamstra Newsgroups: gmane.emacs.devel Subject: Re: Double hyphens in variable names. Date: Fri, 03 Oct 2003 10:39:47 +0200 Organization: CWI, Amsterdam Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <200310021318.h92DIWW05772@raven.dms.auburn.edu> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1065170489 32583 80.91.224.253 (3 Oct 2003 08:41:29 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 3 Oct 2003 08:41:29 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Fri Oct 03 10:41:27 2003 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1A5LV9-0001rt-00 for ; Fri, 03 Oct 2003 10:41:27 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1A5LV9-0001GU-00 for ; Fri, 03 Oct 2003 10:41:27 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.24) id 1A5LUA-0003x1-KP for emacs-devel@quimby.gnus.org; Fri, 03 Oct 2003 04:40:26 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.24) id 1A5LU6-0003wv-Rs for emacs-devel@gnu.org; Fri, 03 Oct 2003 04:40:22 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.24) id 1A5LTa-0003me-30 for emacs-devel@gnu.org; Fri, 03 Oct 2003 04:40:21 -0400 Original-Received: from [192.16.191.8] (helo=hera.cwi.nl) by monty-python.gnu.org with esmtp (Exim 4.24) id 1A5LTZ-0003mD-Gc for emacs-devel@gnu.org; Fri, 03 Oct 2003 04:39:49 -0400 Original-Received: from occarina.pna.cwi.nl (occarina.pna.cwi.nl [192.16.184.200]) by hera.cwi.nl with ESMTP id h938dlFV009060 for ; Fri, 3 Oct 2003 10:39:47 +0200 (MEST) Original-Received: (from lute@localhost) by occarina.pna.cwi.nl (8.12.8/8.12.5) id h938dl9n008763; Fri, 3 Oct 2003 10:39:47 +0200 X-Authentication-Warning: occarina.pna.cwi.nl: lute set sender to Lute.Kamstra@cwi.nl using -f Original-To: Oliver Scholz In-Reply-To: (Oliver Scholz's message of "Thu, 02 Oct 2003 21:04:00 +0200") User-Agent: Gnus/5.1003 (Gnus v5.10.3) Emacs/21.3.50 (gnu/linux) Original-Lines: 27 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.2 Precedence: list List-Id: Emacs development discussions. List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:16899 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:16899 Oliver Scholz writes: > [Not directly related to the question about info:] > > I was always assuming that variables and functions with a double > hyphen after the package prefix are supposed to be strictly > internal. > > If that is true then either `imenu--info-alist' should not start > with a double hyphen or it does not need documentation. Ah, there's a thought! The reason I wanted to document imenu--info-alist is that the manual currently documents imenu-info-alist. I thought the name was changed, but from Imenu's history in CVS I see that it never used imenu-info-alist; it used imenu--info-alist from day one. Imenu's functionality can be easily explained without referring to imenu--info-alist, so I think I'll do that. > I may be wrong, though, and the double hyphen means something > entirely different. It makes sense in this case; I was wondering why the variable was mentioned is the manual as Imenu did not use it to interface with the outside world. Lute.