CXX-2745 add v1 forward headers and component files (bsoncxx)

src/bsoncxx/include/bsoncxx/docs/top.hpp

@@ -81,10 +81,10 @@
 
 ///
 /// @namespace bsoncxx::types
-/// Declares entities representing BSON value types.
+/// Declares entities representing a BSON type.
 ///
 
 ///
 /// @namespace bsoncxx::types::bson_value
-/// Declares entities representing any BSON value type.
+/// Declares entities representing a BSON type.
 ///

src/bsoncxx/include/bsoncxx/docs/v1.hpp

@@ -28,6 +28,11 @@
 /// Provides headers declaring entities in @ref bsoncxx::v1.
 ///
 
+///
+/// @dir bsoncxx/v1/array
+/// Provides headers declaring entities in @ref bsoncxx::v1::array.
+///
+
 ///
 /// @dir bsoncxx/v1/config
 /// Provides headers related to bsoncxx library configuration.
@@ -40,17 +45,47 @@
 /// @warning For internal use only!
 ///
 
+///
+/// @dir bsoncxx/v1/document
+/// Provides headers declaring entities in @ref bsoncxx::v1::document.
+///
+
 ///
 /// @dir bsoncxx/v1/stdx
 /// Provides headers declaring entities in @ref bsoncxx::v1::stdx.
 ///
 
+///
+/// @dir bsoncxx/v1/types
+/// Provides headers declaring entities in @ref bsoncxx::v1::types.
+///
+
 ///
 /// @namespace bsoncxx::v1
 /// Declares entities whose ABI stability is guaranteed for documented symbols.
 ///
 
+///
+/// @namespace bsoncxx::v1::array
+/// @copydoc bsoncxx::array
+///
+
+///
+/// @namespace bsoncxx::v1::document
+/// @copydoc bsoncxx::document
+///
+
+///
+/// @namespace bsoncxx::v1::error
+/// Declares entities describing @ref bsoncxx::v1 errors.
+///
+
 ///
 /// @namespace bsoncxx::v1::stdx
 /// @copydoc bsoncxx::stdx
 ///
+
+///
+/// @namespace bsoncxx::v1::types
+/// @copydoc bsoncxx::types
+///

src/bsoncxx/include/bsoncxx/docs/v_noabi.hpp

@@ -138,7 +138,7 @@
 
 ///
 /// @namespace bsoncxx::v_noabi::types
-/// @copydoc bsoncxx::types
+/// Declares entities representing BSON value types.
 ///
 /// @see
 /// - @ref bsoncxx::v_noabi::types::bson_value

src/bsoncxx/include/bsoncxx/v1/array/element-fwd.hpp

@@ -0,0 +1,34 @@
+// Copyright 2009-present MongoDB, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#pragma once
+
+#include <bsoncxx/v1/detail/prelude.hpp>
+
+namespace bsoncxx {
+namespace v1 {
+namespace array {
+
+class element;
+
+} // namespace array
+} // namespace v1
+} // namespace bsoncxx
+
+#include <bsoncxx/v1/detail/postlude.hpp>
+
+///
+/// @file
+/// Declares @ref bsoncxx::v1::array::element.
+///

src/bsoncxx/include/bsoncxx/v1/array/element.hpp

@@ -0,0 +1,43 @@
+// Copyright 2009-present MongoDB, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#pragma once
+
+#include <bsoncxx/v1/array/element-fwd.hpp>
+
+//
+
+#include <bsoncxx/v1/detail/prelude.hpp>
+
+namespace bsoncxx {
+namespace v1 {
+namespace array {
+
+///
+/// An element within a BSON array.
+///
+/// @attention This feature is experimental! It is not ready for use!
+///
+class element {};
+
+} // namespace array
+} // namespace v1
+} // namespace bsoncxx
+
+#include <bsoncxx/v1/detail/postlude.hpp>
+
+///
+/// @file
+/// Provides @ref bsoncxx::v1::array::element.
+///

src/bsoncxx/include/bsoncxx/v1/array/value-fwd.hpp

@@ -0,0 +1,34 @@
+// Copyright 2009-present MongoDB, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#pragma once
+
+#include <bsoncxx/v1/detail/prelude.hpp>
+
+namespace bsoncxx {
+namespace v1 {
+namespace array {
+
+class value;
+
+} // namespace array
+} // namespace v1
+} // namespace bsoncxx
+
+#include <bsoncxx/v1/detail/postlude.hpp>
+
+///
+/// @file
+/// Declares @ref bsoncxx::v1::array::value.
+///

src/bsoncxx/include/bsoncxx/v1/array/value.hpp

@@ -0,0 +1,43 @@
+// Copyright 2009-present MongoDB, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#pragma once
+
+#include <bsoncxx/v1/array/value-fwd.hpp>
+
+//
+
+#include <bsoncxx/v1/detail/prelude.hpp>
+
+namespace bsoncxx {
+namespace v1 {
+namespace array {
+
+///
+/// A BSON array.
+///
+/// @attention This feature is experimental! It is not ready for use!
+///
+class value {};
+
+} // namespace array
+} // namespace v1
+} // namespace bsoncxx
+
+#include <bsoncxx/v1/detail/postlude.hpp>
+
+///
+/// @file
+/// Provides @ref bsoncxx::v1::array::value.
+///

src/bsoncxx/include/bsoncxx/v1/array/view-fwd.hpp

@@ -0,0 +1,34 @@
+// Copyright 2009-present MongoDB, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#pragma once
+
+#include <bsoncxx/v1/detail/prelude.hpp>
+
+namespace bsoncxx {
+namespace v1 {
+namespace array {
+
+class view;
+
+} // namespace array
+} // namespace v1
+} // namespace bsoncxx
+
+#include <bsoncxx/v1/detail/postlude.hpp>
+
+///
+/// @file
+/// Declares @ref bsoncxx::v1::array::view.
+///

src/bsoncxx/include/bsoncxx/v1/array/view.hpp

@@ -0,0 +1,43 @@
+// Copyright 2009-present MongoDB, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#pragma once
+
+#include <bsoncxx/v1/array/view-fwd.hpp>
+
+//
+
+#include <bsoncxx/v1/detail/prelude.hpp>
+
+namespace bsoncxx {
+namespace v1 {
+namespace array {
+
+///
+/// A non-owning, read-only BSON array.
+///
+/// @attention This feature is experimental! It is not ready for use!
+///
+class view {};
+
+} // namespace array
+} // namespace v1
+} // namespace bsoncxx
+
+#include <bsoncxx/v1/detail/postlude.hpp>
+
+///
+/// @file
+/// Provides @ref bsoncxx::v1::array::view.
+///

src/bsoncxx/include/bsoncxx/v1/decimal128-fwd.hpp

@@ -0,0 +1,32 @@
+// Copyright 2009-present MongoDB, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#pragma once
+
+#include <bsoncxx/v1/detail/prelude.hpp>
+
+namespace bsoncxx {
+namespace v1 {
+
+class decimal128;
+
+} // namespace v1
+} // namespace bsoncxx
+
+#include <bsoncxx/v1/detail/postlude.hpp>
+
+///
+/// @file
+/// Declares @ref bsoncxx::v1::decimal128.
+///

src/bsoncxx/include/bsoncxx/v1/decimal128.hpp

@@ -0,0 +1,41 @@
+// Copyright 2009-present MongoDB, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#pragma once
+
+#include <bsoncxx/v1/decimal128-fwd.hpp>
+
+//
+
+#include <bsoncxx/v1/detail/prelude.hpp>
+
+namespace bsoncxx {
+namespace v1 {
+
+///
+/// A BSON Decimal128.
+///
+/// @attention This feature is experimental! It is not ready for use!
+///
+class decimal128 {};
+
+} // namespace v1
+} // namespace bsoncxx
+
+#include <bsoncxx/v1/detail/postlude.hpp>
+
+///
+/// @file
+/// Provides @ref bsoncxx::v1::decimal128.
+///