Doxygen: Address warnings

Signed-off-by: Simon Rozman <simon@rozman.si>

include/WinStd/Common.h

@@ -112,15 +112,39 @@ private: \
 #define PRINTF_LPOLESTR  "ls"
 #endif
 
+///
+/// Standard input stream for TCHAR strings
+///
 #ifdef _UNICODE
 #define _tcin   (std::wcin )
+#else
+#define _tcin   (std::cin ) ///< Standard input stream for TCHAR strings
+#endif
+
+///
+/// Standard output stream for TCHAR strings
+///
+#ifdef _UNICODE
 #define _tcout  (std::wcout)
+#else
+#define _tcout  (std::cout)
+#endif
+
+///
+/// Standard error stream for TCHAR strings
+///
+#ifdef _UNICODE
 #define _tcerr  (std::wcerr)
+#else
+#define _tcerr  (std::cerr)
+#endif
+
+///
+/// Standard logging stream for TCHAR strings
+///
+#ifdef _UNICODE
 #define _tclog  (std::wclog)
 #else
-#define _tcin   (std::cin )
-#define _tcout  (std::cout)
-#define _tcerr  (std::cerr)
 #define _tclog  (std::clog)
 #endif
 
@@ -821,8 +845,6 @@ namespace winstd
             }
         }
 
-        /// @}
-
     protected:
         ///
         /// Abstract member function that must be implemented by child classes to do the actual object destruction.

include/WinStd/GDI.h

@@ -84,20 +84,32 @@ namespace winstd
     class window_dc : public handle<HDC, NULL>
     {
     public:
+        ///
+        /// Initializes an empty device context.
+        ///
         window_dc() noexcept :
             m_hwnd(NULL)
         {}
 
+        ///
+        /// Initializes a device context from existing data.
+        ///
         window_dc(_In_opt_ handle_type h, _In_opt_ HWND hwnd) noexcept :
             handle<handle_type, NULL>(h),
             m_hwnd(hwnd)
         {}
 
+        ///
+        /// Move an existing device context.
+        ///
         window_dc(_Inout_ window_dc &&h) noexcept :
             handle<handle_type, NULL>(std::move(h)),
             m_hwnd(h.m_hwnd)
         {}
 
+        ///
+        /// Copy an existing device context.
+        ///
         window_dc& operator=(_Inout_ window_dc &&h) noexcept
         {
             handle<handle_type, NULL>::operator=(std::move(h));

include/WinStd/SetupAPI.h

@@ -144,10 +144,12 @@ namespace winstd
         }
 
     protected:
+        /// \cond internal
         HDEVINFO         m_DeviceInfoSet;
         PSP_DEVINFO_DATA m_DeviceInfoData;
         DWORD            m_DriverType;
-        BOOL             m_result;          ///< Did building succeed?
+        BOOL             m_result;
+        /// \endcond
     };
 
     /// @}

include/WinStd/WinTrust.h

@@ -49,9 +49,11 @@ namespace winstd
         }
 
     protected:
+        /// \cond internal
         HWND          m_hwnd;
         GUID          m_action;
         WINTRUST_DATA &m_wtd;
+        /// \endcond
     };
 
     /// @}