docs: Remove duplicate comments in the code

Some comments in the code are duplicate of those in the headers.

Author: xlz

include/libfreenect2/logger.h

@@ -59,6 +59,9 @@ class LIBFREENECT2_API Logger
    * `LIBFREENECT2_LOGGER_LEVEL` can contain a case-insensitive name of level.
    */
   static Level getDefaultLevel();
+
+  /** Convert logging level to a human-readable name.
+   */
   static std::string level2str(Level level);
 
   virtual ~Logger();

src/frame_listener_impl.cpp

@@ -74,11 +74,6 @@ bool SyncMultiFrameListener::hasNewFrame() const
   return impl_->hasNewFrame();
 }
 
-/**
- * Wait for a new set of frames to arrive.
- * @param [out] frame Retrieved frame.
- * @param milliseconds Timeout to wait.
- */
 bool SyncMultiFrameListener::waitForNewFrame(FrameMap &frame, int milliseconds)
 {
 #ifdef LIBFREENECT2_THREADING_STDLIB
@@ -104,10 +99,6 @@ bool SyncMultiFrameListener::waitForNewFrame(FrameMap &frame, int milliseconds)
 #endif // LIBFREENECT2_THREADING_STDLIB
 }
 
-/**
- * Wait for a new set of frames to arrive.
- * @param [out] frame Retrieved frame.
- */
 void SyncMultiFrameListener::waitForNewFrame(FrameMap &frame)
 {
   libfreenect2::unique_lock l(impl_->mutex_);
@@ -122,10 +113,6 @@ void SyncMultiFrameListener::waitForNewFrame(FrameMap &frame)
   impl_->ready_frame_types_ = 0;
 }
 
-/**
- * Free the frames from the synchronized set.
- * @param [inout] frame Frames to release.
- */
 void SyncMultiFrameListener::release(FrameMap &frame)
 {
   for(FrameMap::iterator it = frame.begin(); it != frame.end(); ++it)
@@ -137,11 +124,6 @@ void SyncMultiFrameListener::release(FrameMap &frame)
   frame.clear();
 }
 
-/**
- * Merge an arriving frame into the synchronized set.
- * @param type Type of the new frame.
- * @param frame Received frame.
- */
 bool SyncMultiFrameListener::onNewFrame(Frame::Type type, Frame *frame)
 {
   if((impl_->subscribed_frame_types_ & type) == 0) return false;

src/logging.cpp

@@ -76,11 +76,6 @@ Logger::Level Logger::level() const
   return level_;
 }
 
-/**
- * Convert logging level to a human-readable name.
- * @param l Logging level to convert.
- * @return Human readable name for the logging level.
- */
 std::string Logger::level2str(Level l)
 {
   switch(l)

src/registration.cpp

@@ -103,9 +103,6 @@ void RegistrationImpl::depth_to_color(float mx, float my, float& rx, float& ry)
   ry = (wy / color_q) + color.cy;
 }
 
-/**
- * Undistort/register a single depth data point
- */
 void Registration::apply( int dx, int dy, float dz, float& cx, float &cy) const
 {
   impl_->apply(dx, dy, dz, cx, cy);
@@ -121,18 +118,6 @@ void RegistrationImpl::apply( int dx, int dy, float dz, float& cx, float &cy) co
   cx = rx * color.fx + color.cx;
 }
 
-/**
- * Map color pixels onto depth data, giving an \a registered output image.
- * Optionally, the inverse map can also be obtained through \a bigdepth.
- * @param rgb RGB color image (1920x1080).
- * @param depth Depth image (512x424)
- * @param [out] undistorted Undistorted depth image.
- * @param [out] registered Image color image for the depth data (512x424).
- * @param enable_filter Use a depth buffer to remove pixels which are not visible to both cameras.
- * @param [out] bigdepth If not \c NULL, mapping of depth onto colors (1920x1082 'float' frame).
- * @param [out] color_depth_map If not \c NULL, map (512x424) for storing the color offset for each depth pixel.
- * @note The \a bigdepth frame has a blank top and bottom row.
- */
 void Registration::apply(const Frame *rgb, const Frame *depth, Frame *undistorted, Frame *registered, const bool enable_filter, Frame *bigdepth, int *color_depth_map) const
 {
   impl_->apply(rgb, depth, undistorted, registered, enable_filter, bigdepth, color_depth_map);
@@ -286,18 +271,6 @@ void RegistrationImpl::apply(const Frame *rgb, const Frame *depth, Frame *undist
   if (!color_depth_map) delete[] depth_to_c_off;
 }
 
-/**
- * Computes Euclidean coordinates of a pixel and its color from already registered
- * depth and color frames. I.e. constructs a point to fill a point cloud.
- * @param undistorted Undistorted depth frame from Registration::apply.
- * @param registered Registered color frame from Registration::apply.
- * @param r row index of depth frame this point belong to.
- * @param c column index of depth frame this point belong to.
- * @param[out] x x coordinate of point.
- * @param[out] y y coordinate of point.
- * @param[out] z z coordinate of point.
- * @param[out] RGB associated rgb color of point.
- */
 void Registration::getPointXYZRGB (const Frame* undistorted, const Frame* registered, int r, int c, float& x, float& y, float& z, float& rgb) const
 {
   impl_->getPointXYZRGB(undistorted, registered, r, c, x, y, z, rgb);