Merge pull request #125 from BlueAndi/doxygen_upgrade

Upgrade Doxygen to 1.9.8
BlueAndi · Jun 27, 2024 · 9275c99 · 9275c99
2 parents d056c38 + 3bb4333
commit 9275c99
Show file tree

Hide file tree

Showing 61 changed files with 2,896 additions and 1,160 deletions.
diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
@@ -182,7 +182,7 @@ jobs:
       uses: ts-graphviz/setup-graphviz@v2
 
     - name: Set up doxygen and generate documentation for ${{ matrix.environment }}
-      uses: mattnotmitt/[email protected].5
+      uses: mattnotmitt/[email protected].8
       with:
         working-directory: './doc/doxygen'
         doxyfile-path: './${{ matrix.environment }}Doxyfile'

diff --git a/.gitignore b/.gitignore
@@ -6,4 +6,6 @@
 .vscode/extensions.json
 lib/Webots
 *.wbproj
+webots/worlds/*.jpg
+doc/doxygen/*/*
 __pycache__
diff --git a/doc/doxygen/CalibSimDoxyfile b/doc/doxygen/CalibSimDoxyfile
diff --git a/doc/doxygen/CalibTargetDoxyfile b/doc/doxygen/CalibTargetDoxyfile
diff --git a/doc/doxygen/ConvoyFollowerSimDoxyfile b/doc/doxygen/ConvoyFollowerSimDoxyfile
diff --git a/doc/doxygen/ConvoyFollowerTargetDoxyfile b/doc/doxygen/ConvoyFollowerTargetDoxyfile
diff --git a/doc/doxygen/ConvoyLeaderSimDoxyfile b/doc/doxygen/ConvoyLeaderSimDoxyfile
diff --git a/doc/doxygen/ConvoyLeaderTargetDoxyfile b/doc/doxygen/ConvoyLeaderTargetDoxyfile
diff --git a/doc/doxygen/LineFollowerSimDoxyfile b/doc/doxygen/LineFollowerSimDoxyfile
diff --git a/doc/doxygen/LineFollowerTargetDoxyfile b/doc/doxygen/LineFollowerTargetDoxyfile
diff --git a/doc/doxygen/RemoteControlSimDoxyfile b/doc/doxygen/RemoteControlSimDoxyfile
diff --git a/doc/doxygen/RemoteControlTargetDoxyfile b/doc/doxygen/RemoteControlTargetDoxyfile
diff --git a/doc/doxygen/SensorFusionSimDoxyfile b/doc/doxygen/SensorFusionSimDoxyfile
diff --git a/doc/doxygen/SensorFusionTargetDoxyfile b/doc/doxygen/SensorFusionTargetDoxyfile
diff --git a/lib/APPCalib/src/App.h b/lib/APPCalib/src/App.h
@@ -96,9 +96,23 @@ class App
     /** Timer used for differential drive control processing. */
     SimpleTimer m_controlInterval;
 
-    /* Not allowed. */
-    App(const App& app);            /**< Copy construction of an instance. */
-    App& operator=(const App& app); /**< Assignment of an instance. */
+    /**
+     * Copy construction of an instance.
+     * Not allowed.
+     *
+     * @param[in] app Source instance.
+     */
+    App(const App& app);
+
+    /**
+     * Assignment of an instance.
+     * Not allowed.
+     *
+     * @param[in] app Source instance.
+     *
+     * @returns Reference to App instance.
+     */
+    App& operator=(const App& app);
 };
 
 /******************************************************************************

diff --git a/lib/APPCalib/src/DrivingState.h b/lib/APPCalib/src/DrivingState.h
@@ -137,9 +137,23 @@ class DrivingState : public IState
     {
     }
 
-    /* Not allowed. */
-    DrivingState(const DrivingState& state);            /**< Copy construction of an instance. */
-    DrivingState& operator=(const DrivingState& state); /**< Assignment of an instance. */
+    /**
+     * Copy construction of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     */
+    DrivingState(const DrivingState& state);
+
+    /**
+     * Assignment of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     *
+     * @returns Reference to DrivingState instance.
+     */
+    DrivingState& operator=(const DrivingState& state);
 };
 
 /******************************************************************************

diff --git a/lib/APPCalib/src/ErrorState.h b/lib/APPCalib/src/ErrorState.h
@@ -121,9 +121,23 @@ class ErrorState : public IState
     {
     }
 
-    /* Not allowed. */
-    ErrorState(const ErrorState& state);            /**< Copy construction of an instance. */
-    ErrorState& operator=(const ErrorState& state); /**< Assignment of an instance. */
+    /**
+     * Copy construction of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     */
+    ErrorState(const ErrorState& state);
+
+    /**
+     * Assignment of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     *
+     * @returns Reference to ErrorState instance.
+     */
+    ErrorState& operator=(const ErrorState& state);
 };
 
 /******************************************************************************

diff --git a/lib/APPCalib/src/MotorSpeedCalibrationState.h b/lib/APPCalib/src/MotorSpeedCalibrationState.h
@@ -137,9 +137,23 @@ class MotorSpeedCalibrationState : public IState
     {
     }
 
-    /* Not allowed. */
-    MotorSpeedCalibrationState(const MotorSpeedCalibrationState& state); /**< Copy construction of an instance. */
-    MotorSpeedCalibrationState& operator=(const MotorSpeedCalibrationState& state); /**< Assignment of an instance. */
+    /**
+     * Copy construction of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     */
+    MotorSpeedCalibrationState(const MotorSpeedCalibrationState& state);
+
+    /**
+     * Assignment of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     *
+     * @returns Reference to MotorSpeedCalibrationStateinstance.
+     */
+    MotorSpeedCalibrationState& operator=(const MotorSpeedCalibrationState& state);
 
     /**
      * Determine the max. motor speed, considering both driving directions.

diff --git a/lib/APPCalib/src/ReadyState.h b/lib/APPCalib/src/ReadyState.h
@@ -130,9 +130,23 @@ class ReadyState : public IState
     {
     }
 
-    /* Not allowed. */
-    ReadyState(const ReadyState& state);            /**< Copy construction of an instance. */
-    ReadyState& operator=(const ReadyState& state); /**< Assignment of an instance. */
+    /**
+     * Copy construction of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     */
+    ReadyState(const ReadyState& state);
+
+    /**
+     * Assignment of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     *
+     * @returns Reference to ReadyState instance.
+     */
+    ReadyState& operator=(const ReadyState& state);
 
     /**
      * Show next user info.

diff --git a/lib/APPCalib/src/StartupState.h b/lib/APPCalib/src/StartupState.h
@@ -127,9 +127,23 @@ class StartupState : public IState
     {
     }
 
-    /* Not allowed. */
-    StartupState(const StartupState& state);            /**< Copy construction of an instance. */
-    StartupState& operator=(const StartupState& state); /**< Assignment of an instance. */
+    /**
+     * Copy construction of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     */
+    StartupState(const StartupState& state);
+
+    /**
+     * Assignment of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     *
+     * @returns Reference to StartupState instance.
+     */
+    StartupState& operator=(const StartupState& state);
 
     /**
      * Show next user info.

diff --git a/lib/APPConvoyFollower/src/App.h b/lib/APPConvoyFollower/src/App.h
@@ -193,9 +193,23 @@ class App
      */
     void sendLineSensorsData() const;
 
-    /* Not allowed. */
-    App(const App& app);            /**< Copy construction of an instance. */
-    App& operator=(const App& app); /**< Assignment of an instance. */
+    /**
+     * Copy construction of an instance.
+     * Not allowed.
+     *
+     * @param[in] app Source instance.
+     */
+    App(const App& app);
+
+    /**
+     * Assignment of an instance.
+     * Not allowed.
+     *
+     * @param[in] app Source instance.
+     *
+     * @returns Reference to App instance.
+     */
+    App& operator=(const App& app);
 };
 
 /******************************************************************************

diff --git a/lib/APPConvoyFollower/src/DrivingState.h b/lib/APPConvoyFollower/src/DrivingState.h
@@ -117,9 +117,23 @@ class DrivingState : public IState
     {
     }
 
-    /* Not allowed. */
-    DrivingState(const DrivingState& state);            /**< Copy construction of an instance. */
-    DrivingState& operator=(const DrivingState& state); /**< Assignment of an instance. */
+    /**
+     * Copy construction of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     */
+    DrivingState(const DrivingState& state);
+
+    /**
+     * Assignment of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     *
+     * @returns Reference to DrivingState instance.
+     */
+    DrivingState& operator=(const DrivingState& state);
 };
 
 /******************************************************************************

diff --git a/lib/APPConvoyFollower/src/ErrorState.h b/lib/APPConvoyFollower/src/ErrorState.h
@@ -121,9 +121,23 @@ class ErrorState : public IState
     {
     }
 
-    /* Not allowed. */
-    ErrorState(const ErrorState& state);            /**< Copy construction of an instance. */
-    ErrorState& operator=(const ErrorState& state); /**< Assignment of an instance. */
+    /**
+     * Copy construction of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     */
+    ErrorState(const ErrorState& state);
+
+    /**
+     * Assignment of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     *
+     * @returns Reference to ErrorState instance.
+     */
+    ErrorState& operator=(const ErrorState& state);
 };
 
 /******************************************************************************

diff --git a/lib/APPConvoyFollower/src/LineSensorsCalibrationState.h b/lib/APPConvoyFollower/src/LineSensorsCalibrationState.h
@@ -131,9 +131,23 @@ class LineSensorsCalibrationState : public IState
     {
     }
 
-    /* Not allowed. */
-    LineSensorsCalibrationState(const LineSensorsCalibrationState& state); /**< Copy construction of an instance. */
-    LineSensorsCalibrationState& operator=(const LineSensorsCalibrationState& state); /**< Assignment of an instance. */
+    /**
+     * Copy construction of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     */
+    LineSensorsCalibrationState(const LineSensorsCalibrationState& state);
+
+    /**
+     * Assignment of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     *
+     * @returns Reference to LineSensorsCalibrationState.
+     */
+    LineSensorsCalibrationState& operator=(const LineSensorsCalibrationState& state);
 
     /**
      * Turn and calibrate the line sensors.

diff --git a/lib/APPConvoyFollower/src/StartupState.h b/lib/APPConvoyFollower/src/StartupState.h
@@ -123,9 +123,23 @@ class StartupState : public IState
     {
     }
 
-    /* Not allowed. */
-    StartupState(const StartupState& state);            /**< Copy construction of an instance. */
-    StartupState& operator=(const StartupState& state); /**< Assignment of an instance. */
+    /**
+     * Copy construction of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     */
+    StartupState(const StartupState& state);
+
+    /**
+     * Assignment of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     *
+     * @returns Reference to StartupState instance.
+     */
+    StartupState& operator=(const StartupState& state);
 };
 
 /******************************************************************************

diff --git a/lib/APPConvoyLeader/src/App.h b/lib/APPConvoyLeader/src/App.h
@@ -189,9 +189,23 @@ class App
      */
     bool setupSerialMuxProt();
 
-    /* Not allowed. */
-    App(const App& app);            /**< Copy construction of an instance. */
-    App& operator=(const App& app); /**< Assignment of an instance. */
+    /**
+     * Copy construction of an instance.
+     * Not allowed.
+     *
+     * @param[in] app Source instance.
+     */
+    App(const App& app);
+
+    /**
+     * Assignment of an instance.
+     * Not allowed.
+     *
+     * @param[in] app Source instance.
+     *
+     * @returns Reference to App instance.
+     */
+    App& operator=(const App& app);
 };
 
 /******************************************************************************

diff --git a/lib/APPConvoyLeader/src/DrivingState.h b/lib/APPConvoyLeader/src/DrivingState.h
@@ -166,9 +166,23 @@ class DrivingState : public IState
     {
     }
 
-    /* Not allowed. */
-    DrivingState(const DrivingState& state);            /**< Copy construction of an instance. */
-    DrivingState& operator=(const DrivingState& state); /**< Assignment of an instance. */
+    /**
+     * Copy construction of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     */
+    DrivingState(const DrivingState& state);
+
+    /**
+     * Assignment of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     *
+     * @returns Reference to DrivingState instance.
+     */
+    DrivingState& operator=(const DrivingState& state);
 
     /**
      * Control driving in case the robot is on track.

diff --git a/lib/APPConvoyLeader/src/ErrorState.h b/lib/APPConvoyLeader/src/ErrorState.h
@@ -121,9 +121,23 @@ class ErrorState : public IState
     {
     }
 
-    /* Not allowed. */
-    ErrorState(const ErrorState& state);            /**< Copy construction of an instance. */
-    ErrorState& operator=(const ErrorState& state); /**< Assignment of an instance. */
+    /**
+     * Copy construction of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     */
+    ErrorState(const ErrorState& state);
+
+    /**
+     * Assignment of an instance.
+     * Not allowed.
+     *
+     * @param[in] state Source instance.
+     *
+     * @returns Reference to ErrorState instance.
+     */
+    ErrorState& operator=(const ErrorState& state);
 };
 
 /******************************************************************************