Fix doxygen documentation in src, samples and tests

refs #594

tests/blackmisc/testweather.h

@@ -7,11 +7,15 @@
  * contained in the LICENSE file.
  */
 
-//! \file
-
 #ifndef BLACKMISCTEST_TESTWEATHER_H
 #define BLACKMISCTEST_TESTWEATHER_H
 
+//! \cond PRIVATE_TESTS
+
+/*!
+ * \file
+ */
+
 #include <QtTest/QtTest>
 
 namespace BlackMiscTest
@@ -33,4 +37,6 @@ namespace BlackMiscTest
 
 } // namespace
 
+//! \endcond
+
 #endif // guard