CXX-3085 Upgrade to Doxygen 1.12.0 (#1188)

* CXX-3085 Upgrade to Doxygen 1.12.0

* docs: remove doc for nonexistent namespace bsoncxx::exception

* docs: fix signature of redeclarations of concatenate array overloads

Author: eramongodb

docs/DoxygenLayout.xml

@@ -8,7 +8,7 @@
       <tab type="filelist" visible="yes" title="" intro=""/>
       <tab type="globals" visible="yes" title="" intro=""/>
     </tab>
-    <tab type="modules" visible="yes">
+    <tab type="modules" visible="yes" title="" intro="">
       <tab type="modulelist" visible="yes" title="" intro=""/>
       <tab type="modulemembers" visible="yes" title="" intro=""/>
     </tab>

etc/generate-apidocs-from-tag.pl

@@ -11,7 +11,7 @@
 
 # The required Doxygen version.
 # The generated results are sensitive to the release version.
-our $doxygen_version_required = "1.11.0";
+our $doxygen_version_required = "1.12.0";
 
 # Allow specifying a custom Doxygen binary via the `$DOXYGEN_BINARY` environment variable.
 our $doxygen_binary = $ENV{DOXYGEN_BINARY} || "doxygen";

src/bsoncxx/include/bsoncxx/doc.hpp

@@ -64,11 +64,6 @@
 /// Declares entities representing a BSON document.
 ///
 
-///
-/// @namespace bsoncxx::exception
-/// Declares entities related to bsoncxx exceptions and error codes.
-///
-
 ///
 /// @namespace bsoncxx::stdx
 /// Declares C++17 standard library polyfills.

src/bsoncxx/include/bsoncxx/v_noabi/bsoncxx/builder/basic/helpers.hpp

@@ -57,8 +57,8 @@ namespace basic {
 /// @ref bsoncxx::v_noabi::builder::concatenate(v_noabi::document::view_or_value doc)
 v_noabi::concatenate_doc concatenate(v_noabi::document::view_or_value doc);
 
-/// @ref bsoncxx::v_noabi::builder::concatenate(v_noabi::array::view_or_value doc)
-v_noabi::concatenate_doc concatenate(v_noabi::array::view_or_value doc);
+/// @ref bsoncxx::v_noabi::builder::concatenate(v_noabi::array::view_or_value array)
+v_noabi::concatenate_array concatenate(v_noabi::array::view_or_value array);
 
 }  // namespace basic
 }  // namespace builder

src/bsoncxx/include/bsoncxx/v_noabi/bsoncxx/builder/concatenate.hpp

@@ -140,8 +140,8 @@ namespace builder {
 /// @ref bsoncxx::v_noabi::builder::concatenate(v_noabi::document::view_or_value doc)
 v_noabi::builder::concatenate_doc concatenate(v_noabi::document::view_or_value doc);
 
-/// @ref bsoncxx::v_noabi::builder::concatenate(v_noabi::array::view_or_value doc)
-v_noabi::builder::concatenate_doc concatenate(v_noabi::array::view_or_value doc);
+/// @ref bsoncxx::v_noabi::builder::concatenate(v_noabi::array::view_or_value array)
+v_noabi::builder::concatenate_array concatenate(v_noabi::array::view_or_value array);
 
 }  // namespace builder
 }  // namespace bsoncxx

src/bsoncxx/include/bsoncxx/v_noabi/bsoncxx/fwd.hpp

@@ -375,11 +375,6 @@
 /// @copydoc bsoncxx::document
 ///
 
-///
-/// @namespace bsoncxx::v_noabi::exception
-/// @copydoc bsoncxx::exception
-///
-
 ///
 /// @namespace bsoncxx::v_noabi::stdx
 /// @copydoc bsoncxx::stdx