From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Alan Mackenzie Newsgroups: gmane.emacs.devel Subject: Re: comment-start redefined in cc-langs.el Date: Tue, 2 May 2006 15:55:13 +0000 (GMT) Message-ID: References: <4457572F.2040406@gmx.at> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII X-Trace: sea.gmane.org 1146589817 28161 80.91.229.2 (2 May 2006 17:10:17 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Tue, 2 May 2006 17:10:17 +0000 (UTC) Cc: bug-cc-mode@gnu.org, emacs-devel Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue May 02 19:10:13 2006 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1FayNt-00020u-Un for ged-emacs-devel@m.gmane.org; Tue, 02 May 2006 19:10:02 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FayNt-00041Y-A5 for ged-emacs-devel@m.gmane.org; Tue, 02 May 2006 13:10:01 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1FayNh-00041A-LI for emacs-devel@gnu.org; Tue, 02 May 2006 13:09:49 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1FayNh-00040s-2T for emacs-devel@gnu.org; Tue, 02 May 2006 13:09:49 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FayNg-00040p-TS for emacs-devel@gnu.org; Tue, 02 May 2006 13:09:48 -0400 Original-Received: from [193.149.49.134] (helo=acm.acm) by monty-python.gnu.org with esmtp (Exim 4.52) id 1FayNp-0007vh-Jr; Tue, 02 May 2006 13:09:58 -0400 Original-Received: from localhost (root@localhost) by acm.acm (8.8.8/8.8.8) with SMTP id PAA00794; Tue, 2 May 2006 15:55:14 GMT X-Sender: root@acm.acm Original-To: martin rudalics In-Reply-To: <4457572F.2040406@gmx.at> 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:53804 Archived-At: Hi, Martin! On Tue, 2 May 2006, martin rudalics wrote: >Hi, Alan! > > I'm not sure why it reports cc-engine.el, ... >... because symbol-file finds cc-engine.elc first in load-history, I >presume. I'm sure now! Near the start of cc-engine.el, there's a macro c-declare-lang-variables, which generates a defvar for each symbol stored inside c-lang-variable-inits. 3 of these symbols are comment-start and friends. > > A quick grep for "(c-lang-defvar " reveals that these are > > the only non-CC Mode variables redefined in this way. >While you're here: What about C-h v for non-non-CC Mode variables >defined this way? Some of them (more precisely, those intended to be available to derived modes) have doc-strings. Others are specifically marked as _not_ having doc strings. This has been a little contentious on emacs-devel recently, but if it is to change, it should be done over the whole code atomically. >.. And maybe >(put 'c-lang-defconst 'doc-string-elt 2) What's doc-string-elt? (OK, I can guess, but I can't find it in the Elisp manual). >and eventually >(put 'c-lang-defvar 'doc-string-elt 3) >for ease of reading cc-langs.el? I'm in the middle of documenting the entire language variable mechanism. This thing is a tremendous achievement and saves hours of work, but it is somewhat sparsely commented, and hence difficult to debug. Give me a few days! >Sincerely, martin. -- Alan (Munich, Germany).