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 / t o k s 2 T o C o m O b O b S m S S r C-s r e b o o t C-a C-n C-n C-n M-x c + + m - m o d e M-x f u M-x r e p o r t - 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)