Fix doxygen documentation in src, samples and tests

refs #594

tests/blackmisc/testaviation.h

@@ -7,17 +7,23 @@
  * contained in the LICENSE file.
  */
 
-//! \file
-
 #ifndef BLACKMISCTEST_TESTAVIATIONBASE_H
 #define BLACKMISCTEST_TESTAVIATIONBASE_H
 
+//! \cond PRIVATE_TESTS
+
+/*!
+ * \file
+ */
+
 #include <QtTest/QtTest>
 
 namespace BlackMiscTest
 {
 
-    //! Aviation classes basic tests
+    /*!
+     * Aviation classes basic tests
+     */
     class CTestAviation : public QObject
     {
         Q_OBJECT
@@ -45,4 +51,6 @@ namespace BlackMiscTest
 
 } // namespace
 
+//! \endcond
+
 #endif // guard