Add documentation

Author: gammasoft71

src/xtd.core/CMakeLists.txt

@@ -176,6 +176,8 @@ add_sources(
   include/xtd/double
   include/xtd/double_object.hpp
   include/xtd/double_object
+  include/xtd/dynamic_extent.hpp
+  include/xtd/dynamic_extent
   include/xtd/enum.hpp
   include/xtd/enum
   include/xtd/enum_attribute.hpp

src/xtd.core/include/xtd/dynamic_extent

@@ -0,0 +1,2 @@
+#pragma once
+#include "dynamic_extent.hpp"

src/xtd.core/include/xtd/dynamic_extent.hpp

@@ -0,0 +1,26 @@
+/// @file
+/// @brief Contains xtd::dynamic_extent field.
+/// @copyright Copyright (c) 2025 Gammasoft. All rights reserved.
+#pragma once
+#include "size.hpp"
+#include <limits>
+
+/// @brief The xtd namespace contains all fundamental classes to access Hardware, Os, System, and more.
+namespace xtd {
+  /// @name Static Fields
+  
+  /// @{
+  /// @brief Represents the constant of type xtd::size signifying that the span has dynamic extent
+  /// @remarks xtd::dynamic_extent is a constant of type xtd::size that is generally used to indicate that any type using xtd::dynamic_extent will dynamically store its value (e.g., size) rather than having the value statically known in the type.
+  /// @par Header
+  /// ```cpp
+  /// #include <xtd/dynamic_extent>
+  /// ```
+  /// @par Namespace
+  /// xtd
+  /// @par Library
+  /// xtd.core
+  /// @ingroup xtd_core system
+  inline constexpr xtd::size dynamic_extent = std::numeric_limits<xtd::size>::max();
+  /// @}
+}

src/xtd.core/include/xtd/span.hpp

@@ -6,21 +6,18 @@
 #include "collections/generic/helpers/wrap_pointer_reverse_iterator.hpp"
 #include "argument_null_exception.hpp"
 #include "argument_out_of_range_exception.hpp"
+#include "dynamic_extent.hpp"
 #include "iequatable.hpp"
 #include "is.hpp"
 #include "null.hpp"
 #include "object.hpp"
 #include "ptrdiff.hpp"
-#include "size.hpp"
 #include "typeof.hpp"
-#include <limits>
 #include <type_traits>
 #include <vector>
 
 /// @brief The xtd namespace contains all fundamental classes to access Hardware, Os, System, and more.
 namespace xtd {
-  inline constexpr xtd::size dynamic_extent = std::numeric_limits<xtd::size>::max();
-  
   template<class type_t, xtd::size extent = dynamic_extent>
   class span : public xtd::object, public xtd::iequatable<xtd::span<type_t, extent>> {
   public: