D18683: Overhaul doxygen comments

zzag created this revision.
zzag added a reviewer: KWin.
Herald added a project: KWin.
Herald added a subscriber: kwin.
zzag requested review of this revision.

REVISION SUMMARY
  We have a mix of different doxygen comment styles, e.g.
  
    /*!
      Foo bar.
     */
    
    /**
     * Foo bar.
     */
    
    /** Foo bar.
     */
    
    /**
     * Foo bar.
     */
    
    /**
     * Foo bar.
     **/
  
  To make the code more consistent, this change updates the style of all
  doxygen comments to the last one.

TEST PLAN
  Compiles.

REPOSITORY
  R108 KWin

BRANCH
  uniform-doxygen-comments

REVISION DETAIL
  https://phabricator.kde.org/D18683

AFFECTED FILES
  abstract_client.h
  abstract_output.h
  activation.cpp
  activities.h
  client.cpp
  client.h
  colorcorrection/constants.h
  composite.h
  cursor.h
  dbusinterface.h
  effectloader.h
  effects.h
  effects/slide/slide.cpp
  events.cpp
  geometry.cpp
  globalshortcuts.h
  group.cpp
  input.h
  kcmkwin/kwinscripts/module.h
  kcmkwin/kwintabbox/layoutpreview.h
  keyboard_input.h
  layers.cpp
  libkwineffects/anidata_p.h
  libkwineffects/kwineffects.h
  libkwineffects/kwinglobals.h
  libkwineffects/kwinglplatform.h
  libkwineffects/kwingltexture.h
  libkwineffects/kwinglutils.h
  libkwineffects/kwinxrenderutils.h
  main.h
  netinfo.h
  options.h
  outline.h
  placement.cpp
  placement.h
  platform.h
  platformsupport/scenes/opengl/backend.h
  platformsupport/scenes/qpainter/backend.h
  plugins/kdecorations/aurorae/src/colorhelper.h
  plugins/kdecorations/aurorae/src/decorationoptions.h
  plugins/kdecorations/aurorae/src/lib/auroraetheme.h
  plugins/kdecorations/aurorae/themes/plastik/code/plastikbutton.h
  plugins/platforms/drm/drm_backend.h
  plugins/platforms/drm/egl_gbm_backend.h
  plugins/platforms/wayland/wayland_backend.h
  plugins/platforms/x11/standalone/x11cursor.h
  plugins/scenes/opengl/scene_opengl.cpp
  plugins/scenes/xrender/scene_xrender.h
  pointer_input.h
  scene.h
  screenedge.h
  screens.h
  scripting/dbuscall.h
  scripting/meta.h
  scripting/screenedgeitem.h
  scripting/scriptedeffect.h
  scripting/scripting.h
  scripting/scripting_model.h
  scripting/workspace_wrapper.h
  shell_client.h
  sm.cpp
  tabbox/clientmodel.h
  tabbox/desktopmodel.h
  tabbox/switcheritem.h
  tabbox/tabbox.cpp
  tabbox/tabbox.h
  tabbox/tabboxconfig.h
  tabbox/tabboxhandler.cpp
  tabbox/tabboxhandler.h
  tabgroup.h
  toplevel.cpp
  toplevel.h
  useractions.cpp
  utils.h
  virtualdesktops.h
  wayland_server.h
  workspace.cpp
  workspace.h
  x11eventfilter.h
  xcbutils.h

To: zzag, #kwin
Cc: kwin, jraleigh, GB_2, mkulinski, ragreen, jackyalcine, Pitel, iodelay, bwowk, ZrenBot, ngraham, alexeymin, lesliezhai, ali-mohamed, hardening, jensreuterberg, abetts, sebas, apol, mart