Added some markup for doxygen, fixed a doxygen warning

SVN-Revision: 4424

diff --git a/src/object/ambient_sound.hpp b/src/object/ambient_sound.hpp
index 948df9c..8f4dbbc 100644 (file)
--- a/src/object/ambient_sound.hpp
+++ b/src/object/ambient_sound.hpp
@@ -67,11 +67,16 @@ public:
     return position;
   }
 
-  // --- Scripting Interface ---
-
+  /** 
+   * @name Scriptable Methods
+   * @{ 
+   */
   void set_pos(float x, float y);
   float get_pos_x() const;
   float get_pos_y() const;
+  /** 
+   * @} 
+   */
 
 protected:
   virtual void hit(Player& player);

diff --git a/src/object/background.hpp b/src/object/background.hpp
index 6b4625e..3321c92 100644 (file)
--- a/src/object/background.hpp
+++ b/src/object/background.hpp
@@ -62,7 +62,7 @@ private:
   float speed_y; /**< scroll-speed in vertical direction */
   std::auto_ptr<Surface> image_top; /**< image to draw above pos */
   std::auto_ptr<Surface> image; /**< image to draw, anchored at pos */
-  std::auto_ptr<Surface> image_bottom; /**< image to draw below pos+<screenheight> */
+  std::auto_ptr<Surface> image_bottom; /**< image to draw below pos+screenheight */
 };
 
 #endif /*SUPERTUX_BACKGROUND_H*/

diff --git a/src/object/candle.hpp b/src/object/candle.hpp
index 95d005a..f461a06 100644 (file)
--- a/src/object/candle.hpp
+++ b/src/object/candle.hpp
@@ -42,10 +42,16 @@ public:
   virtual void expose(HSQUIRRELVM vm, SQInteger table_idx);
   virtual void unexpose(HSQUIRRELVM vm, SQInteger table_idx);
 
+  /** 
+   * @name Scriptable Methods
+   * @{ 
+   */
   void puff_smoke(); /**< spawn a puff of smoke */
-
   bool get_burning(); /**< returns true if candle is lighted */
   void set_burning(bool burning); /**< true: light candle, false: extinguish candle */
+  /** 
+   * @} 
+   */
 
 private:
   bool burning; /**< true if candle is currently lighted */

diff --git a/src/object/display_effect.hpp b/src/object/display_effect.hpp
index 582dcbe..d10ab80 100644 (file)
--- a/src/object/display_effect.hpp
+++ b/src/object/display_effect.hpp
@@ -37,6 +37,12 @@ public:
     void update(float elapsed_time);
     void draw(DrawingContext& context);
 
+
+    /** 
+     * @name Scriptable Methods
+     * @{ 
+     */
+
     void fade_out(float fadetime);
     void fade_in(float fadetime);
     void set_black(bool enabled);
@@ -44,6 +50,10 @@ public:
     void sixteen_to_nine(float fadetime);
     void four_to_three(float fadetime);
 
+    /** 
+     * @} 
+     */
+
 private:
     enum FadeType {
         NO_FADE, FADE_IN, FADE_OUT

diff --git a/src/object/level_time.hpp b/src/object/level_time.hpp
index 98c7926..45f001a 100644 (file)
--- a/src/object/level_time.hpp
+++ b/src/object/level_time.hpp
@@ -38,6 +38,11 @@ public:
     void update(float elapsed_time);
     void draw(DrawingContext& context);
 
+    /** 
+     * @name Scriptable Methods
+     * @{ 
+     */
+
     /**
      * Resumes the countdown
      */
@@ -58,6 +63,10 @@ public:
      */
     void set_time(float time_left);
 
+    /** 
+     * @} 
+     */
+
 private:
     std::auto_ptr<Surface> time_surface;
     bool running;

diff --git a/src/object/platform.hpp b/src/object/platform.hpp
index 74cd704..0815a71 100644 (file)
--- a/src/object/platform.hpp
+++ b/src/object/platform.hpp
@@ -44,6 +44,11 @@ public:
     return speed;
   }
 
+  /** 
+   * @name Scriptable Methods
+   * @{ 
+   */
+
   /** Move platform until at given node, then stop */
   void goto_node(int node_no);
 
@@ -53,6 +58,10 @@ public:
   /** Stop platform at next node */
   void stop_moving();
 
+  /** 
+   * @} 
+   */
+
   virtual void expose(HSQUIRRELVM vm, SQInteger table_idx);
   virtual void unexpose(HSQUIRRELVM vm, SQInteger table_idx);
 

diff --git a/src/object/thunderstorm.hpp b/src/object/thunderstorm.hpp
index afbc5ac..7aa8173 100644 (file)
--- a/src/object/thunderstorm.hpp
+++ b/src/object/thunderstorm.hpp
@@ -40,6 +40,11 @@ public:
     virtual void expose(HSQUIRRELVM vm, SQInteger table_idx);
     virtual void unexpose(HSQUIRRELVM vm, SQInteger table_idx);
 
+    /** 
+     * @name Scriptable Methods
+     * @{ 
+     */
+
     /**
      * Start playing thunder and lightning at configured interval
      */
@@ -70,6 +75,10 @@ public:
      */
     void electrify();
 
+    /** 
+     * @} 
+     */
+
 private:
     bool running; /**< whether we currently automatically trigger lightnings */
     float interval; /**< time between two lightnings */

diff --git a/src/object/wind.hpp b/src/object/wind.hpp
index 53304d6..864ca80 100644 (file)
--- a/src/object/wind.hpp
+++ b/src/object/wind.hpp
@@ -40,6 +40,11 @@ public:
   void draw(DrawingContext& context);
   HitResponse collision(GameObject& other, const CollisionHit& hit);
 
+  /** 
+   * @name Scriptable Methods
+   * @{ 
+   */
+
   /**
    * start blowing
    */
@@ -50,6 +55,10 @@ public:
    */
   void stop();
 
+  /** 
+   * @} 
+   */
+
   virtual void expose(HSQUIRRELVM vm, SQInteger table_idx);
   virtual void unexpose(HSQUIRRELVM vm, SQInteger table_idx);