Prepare v3.0.0-beta1.

CHANGELOG.md

@@ -1,4 +1,29 @@
 # Changes
+## Version 3.0.0-beta - 2024-07-16
+This version is a major one and is breaking some usage compare to v2.
+Read the migration guide from the documentation: https://bluebrain.github.io/HighFive/md__2home_2runner_2work_2_high_five_2_high_five_2doc_2migration__guide.html
+
+The minimum version for C++ has been moved to `C++14`.
+
+If you want to cite us, we now are on Zenodo: https://zenodo.org/records/10679738
+
+### Removed
+    - Removed `read(T*, ...)`, use explicit `read_raw(T*, ...)` for `Slice` or `Attribute`. (#928)
+    - Removed `FixedLenStringArray`. Use any container with strings instead. (#932)
+    - Removed `FileDriver` and `MPIOFileDriver` use file access properties instead. (#949)
+    - Removed default constructor for `Group` and `DataSet`. (#947, #948)
+    - Broadcasting have been removed. Use `squeeze` and `reshape` feature instead. (#992)
+    - `ObjectCreateProps` and `ObjectAccessProps` those do not really exist in hdf5. (#1002)
+
+### New Features
+    - Support for `std::span`. (#987)
+    - Add `squeezeMemSpace` and `reshapeMemSpace` for `Attribute` and `Slice` to reshape the memory space. (#991)
+    - `ProductSet` let you select a cartesian product of slices. (#842)
+
+### Improvements
+    - Type `T[N]` or `T[N][M]` will works better. (#929)
+    - `DataspaceType` is now an enum class for `dataspace_scalar` or `dataspace_null`. (#900)
+
 ## Version 2.9.0 - 2024-01-25
 ### New Features
     - Add named ctors for scalar and null dataspaces. (#899)

include/highfive/bits/H5Slice_traits.hpp

@@ -296,6 +296,7 @@ class HyperSlab {
 ///
 /// Note that the selections along each axis must be sorted and non-overlapping.
 ///
+/// \since 3.0
 class ProductSet {
   public:
     template <class... Slices>
@@ -356,6 +357,11 @@ class SliceTraits {
     ///
     Selection select(const ElementSet& elements) const;
 
+    ///
+    /// \brief Select a region consisting of a product of slices.
+    ///
+    /// \since 3.0
+    ///
     Selection select(const ProductSet& product_set) const;
 
     template <typename T>