Convert documents to follow the doxygen standard (fdo#44502, fdo#39468)

Change-Id: I58c73f74d53b5dc2eb462fb03664be65d4500170
Reviewed-by: Philipp Riemer <ruderphilipp@gmail.com>

3 files changed, 9 insertions, 16 deletions

diff --git a/sd/source/ui/animations/motionpathtag.hxx b/sd/source/ui/animations/motionpathtag.hxx
index 12ff8ee46c29..867a81fab099 100644
--- a/sd/source/ui/animations/motionpathtag.hxx
+++ b/sd/source/ui/animations/motionpathtag.hxx
@@ -34,12 +34,7 @@ namespace sd {
 class View;
 class CustomAnimationPane;
 
-/*************************************************************************
-|*
-|* Basisklasse fuer alle Funktionen
-|*
-\************************************************************************/
-
+/// Base class for all functions.
 class MotionPathTag : public SmartTag, public IPolyPolygonEditorController, public SfxListener, public ::com::sun::star::util::XChangesListener
 {
 public:
@@ -48,10 +43,10 @@ public:
 
     SdrPathObj* getPathObj() const { return mpPathObj; }
 
-    /** returns true if the SmartTag handled the event. */
+    /// @return true if the SmartTag handled the event.
     virtual bool MouseButtonDown( const MouseEvent&, SmartHdl& );
 
-    /** returns true if the SmartTag consumes this event. */
+    /// @return true if the SmartTag consumes this event.
     virtual bool KeyInput( const KeyEvent& rKEvt );
 
     // callbacks from sdr view
diff --git a/sd/source/ui/annotations/annotationtag.hxx b/sd/source/ui/annotations/annotationtag.hxx
index 7732467b4177..9deae0b0d0a3 100644
--- a/sd/source/ui/annotations/annotationtag.hxx
+++ b/sd/source/ui/annotations/annotationtag.hxx
@@ -39,16 +39,16 @@ public:
     AnnotationTag( AnnotationManagerImpl& rManager, ::sd::View& rView, const css::uno::Reference< css::office::XAnnotation >& xAnnotation, Color& rColor, int nIndex, const Font& rFont );
     virtual ~AnnotationTag();
 
-    /** returns true if the SmartTag handled the event. */
+    /// @return true if the SmartTag handled the event.
     virtual bool MouseButtonDown( const MouseEvent&, SmartHdl& );
 
-    /** returns true if the SmartTag consumes this event. */
+    /// @return true if the SmartTag consumes this event.
     virtual bool KeyInput( const KeyEvent& rKEvt );
 
-    /** returns true if the SmartTag consumes this event. */
+    /// @return true if the SmartTag consumes this event.
     virtual bool RequestHelp( const HelpEvent& rHEvt );
 
-    /** returns true if the SmartTag consumes this event. */
+    /// @return true if the SmartTag consumes this event.
     virtual bool Command( const CommandEvent& rCEvt );
 
     // callbacks from sdr view
@@ -61,8 +61,6 @@ public:
     void Move( int nDX, int nDY );
     bool OnMove( const KeyEvent& rKEvt );
 
-    // ---
-
     BitmapEx CreateAnnotationBitmap(bool);
 
     css::uno::Reference< css::office::XAnnotation > GetAnnotation() const { return mxAnnotation; }
diff --git a/sd/source/ui/presenter/CanvasUpdateRequester.hxx b/sd/source/ui/presenter/CanvasUpdateRequester.hxx
index 0800a27b6ee8..e2fe5483b49a 100644
--- a/sd/source/ui/presenter/CanvasUpdateRequester.hxx
+++ b/sd/source/ui/presenter/CanvasUpdateRequester.hxx
@@ -41,8 +41,8 @@ namespace sd { namespace presenter {
 class CanvasUpdateRequester : private ::boost::noncopyable
 {
 public:
-    /** Return the Canvas UpdateRequester object for the given shared
-        canvas.  A new object is created when it does not already exist.
+    /** @return the Canvas UpdateRequester object for the given shared canvas.
+                A new object is created when it does not already exist.
     */
     static ::boost::shared_ptr<CanvasUpdateRequester> Instance (
         const css::uno::Reference<css::rendering::XSpriteCanvas>& rxCanvas);