all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Alan Mackenzie <acm@muc.de>
Cc: bug-cc-mode@gnu.org, emacs-devel <emacs-devel@gnu.org>
Subject: Re: comment-start redefined in cc-langs.el
Date: Tue, 2 May 2006 15:55:13 +0000 (GMT)	[thread overview]
Message-ID: <Pine.LNX.3.96.1060502154316.310C-100000@acm.acm> (raw)
In-Reply-To: <4457572F.2040406@gmx.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).

  reply	other threads:[~2006-05-02 15:55 UTC|newest]

Thread overview: 9+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2006-04-29 14:41 comment-start redefined in cc-langs.el martin rudalics
2006-05-02  7:58 ` Alan Mackenzie
2006-05-02 12:57   ` martin rudalics
2006-05-02 15:55     ` Alan Mackenzie [this message]
2006-07-20 10:44 ` Alan Mackenzie
2006-07-21 16:05   ` martin rudalics
2006-07-21 22:52     ` Alan Mackenzie
2006-07-21 22:13       ` martin rudalics
2006-07-24  6:59       ` martin rudalics

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=Pine.LNX.3.96.1060502154316.310C-100000@acm.acm \
    --to=acm@muc.de \
    --cc=bug-cc-mode@gnu.org \
    --cc=emacs-devel@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.