-----Original Message-----
From: Helmut Eller <heller@common-lisp.net>

* Mark Evenson [2010-01-28 10:49+0100] writes:

> Is there a convention to specify which specialization of a CL generic 
> function a comment refers to?  Emacs 23.1 just seems to go to the first 
> DEFMETHOD it finds.

No official one and nothing that would be supported.  I tend to write
things like: (inspect-object (cons)).

Helmut


---- 

Beware of using nested parenthesized expressions if you want to
maintain the hypertext capability of Change Log mode.  For example,

   * slime.el (inspect-object (cons)): [descriptive text]

would lead C-c C-c to attempt to locate the definition of the symbol
`cons' in the file slime.el, which is probably not what you want.  The
regular expression that Change Log mode uses to identify a symbol in
parentheses locates the symbol in the inner-most set of parentheses,
rather than the outer-most set of parentheses.

If they want to gain the hypertext- like capability that Change Log
mode provides, then writers of ChangeLog entries may want to stick to
the simple rule of providing filenames and parenthesized (optionally,
comma-separated lists of) symbols whose definitions have been added,
changed, or deleted, followed by colons and descriptions.  Then the
burden of providing detail about the change falls to the description.