Re: font-lock-comment-delimiter-face

[Luc Teirlinck]

Richard Stallman wrote:

   I installed this because it seems to be the only good way to resolve
   the problem that was encountered with fontification and Rmail to
   general satisfaction.  (No one objected to this solution.)

If nothing else. the defface docstring seems wrong:

  "Font Lock mode face used to highlight comments."

The defvar docstring (which does not appear in the Custom buffer)
more accurately says:

  "Face name to use for comment delimiters."

The best solution would seem to go for a mail specific face.
Alternatively, one could write in the defvar and defface docstrings:

  "Font Lock mode face used to highlight comment delimiters.
This is currently only used in a limited number of modes such as
rmail-mode and mail-mode.  In other modes, comment delimiters get
fontified using `font-lock-comment-face'."

Sincerely,

Luc.