bug#11865: 24.1.50; doxygen comments not highlighted in c++-mode

[Toon Claes]

I am using doxygen.org to comment code (and generate documentation
from it). This requires a dedicated commenting style, e.g.:

    /**
     * This is a doxygen comment
     * @param par this is a parameter for this function
     * @return this is what is returned by the function
     */
    bool my_function(int par);

When this snippet is viewed with major mode 'c-mode', the @-keywords are
highlighted. When you set the major mode to 'c++-mode', this is not the
case.

So for some reason this additional highlighting is not enabled for
c++. I am not sure if this is a bug, or disabled on purpose. Anyhow,
using doxygen for c++ is valid.

Also it seems the doxygen highlighting does not work when you type
comments on the same line as the '/**', e.g. like this:
    /** This comment is not doxygen-highlighted
     */


Regards,
Toon



In GNU Emacs 24.1.50.1 (i686-suse-linux-gnu, X toolkit)
 of 2012-06-20 on suse12-tcl
Bzr revision: 108664 eggert@cs.ucla.edu-20120619185739-mile4zpnjrqz5e8e
Windowing system distributor `The X.Org Foundation', version 11.0.11004000
Configured using:
 `configure '--without-toolkit-scroll-bars''

Important settings:
  value of $LC_CTYPE: en_US.UTF-8
  value of $LANG: en_US.UTF-8
  value of $XMODIFIERS: @im=local
  locale-coding-system: utf-8-unix
  default enable-multibyte-characters: t

Major mode: C++/l

Minor modes in effect:
  tooltip-mode: t
  mouse-wheel-mode: t
  tool-bar-mode: t
  menu-bar-mode: t
  file-name-shadow-mode: t
  global-font-lock-mode: t
  font-lock-mode: t
  blink-cursor-mode: t
  auto-composition-mode: t
  auto-encryption-mode: t
  auto-compression-mode: t
  line-number-mode: t
  transient-mark-mode: t
  abbrev-mode: t

Recent input:
C-x C-f <up> / t o k <tab> s <tab> 2 <tab> T o <tab>
C o m <tab> O b <tab> O b <tab> S <tab> m <tab> S <tab>
S r <backspace> <tab> <return> C-s r e b o o t C-a
C-n C-n C-n M-x c + + m <backspace> - m o d e <return>
M-x f u <backspace> <backspace> <help-echo> M-x r e
p o r t - <tab> <return>

Recent messages:
For information about GNU Emacs and the GNU system, type C-h C-a.
user-error: Beginning of history; no preceding item
Making completion list...
Note: file is write protected
Loading cc-langs...done
Mark saved where search started
completing-read-default: Command attempted to use minibuffer while in minibuffer

Load-path shadows:
None found.

Features:
(shadow sort gnus-util mail-extr emacsbug message cl-macs format-spec
rfc822 mml mml-sec mm-decode mm-bodies mm-encode mail-parse rfc2231
mailabbrev gmm-utils mailheader sendmail rfc2047 rfc2045 ietf-drums
mm-util mail-prsvr mail-utils multi-isearch cc-langs cl macroexp cl-lib
cc-mode cc-fonts cc-guess cc-menus cc-cmds cc-styles cc-align cc-engine
cc-vars cc-defs help-mode easymenu view time-date tooltip ediff-hook
vc-hooks lisp-float-type mwheel x-win x-dnd tool-bar dnd fontset image
regexp-opt fringe tabulated-list newcomment lisp-mode register page
menu-bar rfn-eshadow timer select scroll-bar mouse jit-lock font-lock
syntax facemenu font-core frame cham georgian utf-8-lang misc-lang
vietnamese tibetan thai tai-viet lao korean japanese hebrew greek
romanian slovak czech european ethiopic indian cyrillic chinese
case-table epa-hook jka-cmpr-hook help simple abbrev minibuffer loaddefs
button faces cus-face files text-properties overlay sha1 md5 base64
format env code-pages mule custom widget hashtable-print-readable
backquote make-network-process dbusbind dynamic-setting
system-font-setting font-render-setting x-toolkit x multi-tty emacs)