resolve long-standing doxygen warnings

Core/Simulation/DepthProbeSimulation.h

@@ -73,6 +73,7 @@ private:
     std::vector<DepthProbeElement> generateElements(const Beam& beam);
 
     //! Generate a single threaded computation for a given range of simulation elements
+    //! @param re_sample Preprocessed version of our sample
     //! @param start Index of the first element to include into computation
     //! @param n_elements Number of elements to process
     std::unique_ptr<IComputation> createComputation(const ProcessedSample& re_sample, size_t start,

Core/Simulation/ISimulation.h

@@ -123,6 +123,7 @@ private:
                              size_t batch_size, double weight = 1.0);
 
     //! Generate a single threaded computation for a given range of simulation elements
+    //! @param re_sample Preprocessed version of our sample
     //! @param start Index of the first element to include into computation
     //! @param n_elements Number of elements to process
     virtual std::unique_ptr<IComputation> createComputation(const ProcessedSample& re_sample,

Core/Simulation/ISimulation2D.h

@@ -73,6 +73,7 @@ protected:
     size_t numberOfElements() const override;
 
     //! Generate a single threaded computation for a given range of simulation elements
+    //! @param re_sample Preprocessed version of our sample
     //! @param start Index of the first element to include into computation
     //! @param n_elements Number of elements to process
     std::unique_ptr<IComputation> createComputation(const ProcessedSample& re_sample, size_t start,

Core/Simulation/SpecularSimulation.h

@@ -64,6 +64,7 @@ private:
     void initElementVector() override;
 
     //! Generate a single threaded computation for a given range of simulation elements
+    //! @param re_sample Preprocessed version of our sample
     //! @param start Index of the first element to include into computation
     //! @param n_elements Number of elements to process
     std::unique_ptr<IComputation> createComputation(const ProcessedSample& re_sample, size_t start,

Device/Mask/Rectangle.cpp

@@ -19,6 +19,7 @@
 //! @param ylow y-coordinate of lower left corner
 //! @param xup x-coordinate of upper right corner
 //! @param yup y-coordinate of upper right corner
+//! @param inverted swap inside/outside
 Rectangle::Rectangle(double xlow, double ylow, double xup, double yup, bool inverted)
     : IShape2D("Rectangle"), m_inverted(inverted)
 {