document begin end

Author: alfC

include/boost/multi/array_ref.hpp

@@ -3425,8 +3425,8 @@ struct const_subarray<T, 1, ElementPtr, Layout>  // NOLINT(fuchsia-multiple-inhe
 #endif
 
  public:
-	BOOST_MULTI_HD constexpr auto begin() const& -> const_iterator { return begin_aux_(); }
-	BOOST_MULTI_HD constexpr auto end() const& -> const_iterator { return end_aux_(); }
+	BOOST_MULTI_HD constexpr auto begin() const& -> const_iterator { return begin_aux_(); }  ///< returns a iterator to the beginning
+	BOOST_MULTI_HD constexpr auto end() const& -> const_iterator { return end_aux_(); }  ///< returns a iterator to the end
 
 #if defined(__GNUC__) && !defined(__EDG__)
 #pragma GCC diagnostic push
@@ -3438,11 +3438,11 @@ struct const_subarray<T, 1, ElementPtr, Layout>  // NOLINT(fuchsia-multiple-inhe
 #pragma GCC diagnostic pop
 #endif
 
-	BOOST_MULTI_HD constexpr auto cbegin() const& -> const_iterator { return begin(); }
-	BOOST_MULTI_HD constexpr auto cend() const& -> const_iterator { return end(); }
+	BOOST_MULTI_HD constexpr auto cbegin() const& -> const_iterator { return begin(); }  ///< returns an (explicitly const-)iterator to the beginning
+	BOOST_MULTI_HD constexpr auto cend() const& -> const_iterator { return end(); }  ///< returns an (explicitly const-)iterator to the end
 
-	BOOST_MULTI_FRIEND_CONSTEXPR auto cbegin(const_subarray const& self) { return self.cbegin(); }
-	BOOST_MULTI_FRIEND_CONSTEXPR auto cend(const_subarray const& self) { return self.cend(); }
+	// BOOST_MULTI_FRIEND_CONSTEXPR auto cbegin(const_subarray const& self) { return self.cbegin(); }
+	// BOOST_MULTI_FRIEND_CONSTEXPR auto cend(const_subarray const& self) { return self.cend(); }
 
 	template<class It> constexpr auto assign(It first) && -> decltype(adl_copy_n(first, std::declval<size_type>(), std::declval<iterator>()), void()) {
 		return adl_copy_n(first, this->size(), std::move(*this).begin()), void();