fix docs (#1633)

cmake-modules/AzureDoxygen.cmake

@@ -25,9 +25,8 @@ function(generate_documentation PROJECT_NAME PROJECT_VERSION)
             test
             *private*)
         # Skip documenting Details symbols (all from ::Details namespace)
-        set(DOXYGEN_EXCLUDE_SYMBOLS Details)
+        set(DOXYGEN_EXCLUDE_SYMBOLS Details Internal)
         set(DOXYGEN_IGNORE_PREFIX az_ AZ_)
-        set(DOXYGEN_)
         set(DOXYGEN_HTML_HEADER ${CMAKE_SOURCE_DIR}/eng/docs/api/assets/header.html)
         set(DOXYGEN_HTML_FOOTER ${CMAKE_SOURCE_DIR}/eng/docs/api/assets/footer.html)
         set(DOXYGEN_HTML_STYLESHEET ${CMAKE_SOURCE_DIR}/eng/docs/api/assets/style.css)

sdk/core/azure-core/inc/azure/core/context.hpp

@@ -19,7 +19,8 @@
 namespace Azure { namespace Core {
 
   /**
-   * @ A base abstract class for the `std::unique_ptr` value representation in #ContextValue.
+   * @brief A base abstract class for the `std::unique_ptr` value representation in #ContextValue.
+   *
    */
   struct ValueBase
   {

sdk/core/azure-core/inc/azure/core/http/policy.hpp

@@ -73,7 +73,10 @@ namespace Azure { namespace Core { namespace Http {
     HttpPolicy& operator=(const HttpPolicy& other) = default;
   };
 
-  // Represents the next HTTP policy in the stack sequence of policies.
+  /**
+   * @brief Represents the next HTTP policy in the stack sequence of policies.
+   *
+   */
   class NextHttpPolicy {
     const std::size_t m_index;
     const std::vector<std::unique_ptr<HttpPolicy>>& m_policies;

sdk/core/azure-core/inc/azure/core/http/winhttp/win_http_client.hpp

@@ -2,6 +2,7 @@
 // SPDX-License-Identifier: MIT
 
 /**
+ * @file
  * @brief #HttpTransport implementation via WinHttp.
  */
 

sdk/core/azure-core/inc/azure/core/internal/json_serializable.hpp

@@ -2,6 +2,7 @@
 // SPDX-License-Identifier: MIT
 
 /**
+ * @file
  * @brief Internal interface for serializable classes.
  *
  */

sdk/core/azure-core/inc/azure/core/internal/strings.hpp

@@ -2,6 +2,7 @@
 // SPDX-License-Identifier: MIT
 
 /**
+ * @file
  * @brief Internal utility functions for strings.
  *
  */