Clean up release notes

takluyver · takluyver · commit 8f513ced5ecb · 2024-04-05T11:43:20.000+01:00
diff --git a/docs/high/group.rst b/docs/high/group.rst
@@ -277,6 +277,19 @@ Reference
         In this case `object` will be a :class:`Group` or :class:`Dataset`
         instance.
 
+    .. method:: visit_links(callable)
+                visititems_links(callable)
+
+       These methods are like :meth:`visit` and :meth:`visititems`, but work on
+       the links in groups, rather than the objects those links point to. So if
+       you have two links pointing to the same object, these will 'see' both.
+       They also see soft & external links, which :meth:`visit` and
+       :meth:`visititems` ignore.
+
+       The second argument to the callback for ``visititems_links`` is an
+       instance of one of the :ref:`link classes <group_link_classes>`.
+
+       .. versionadded:: 3.11
 
     .. method:: move(source, dest)
 
@@ -516,6 +529,7 @@ Reference
 
         :class:`Group` instance containing this group.
 
+.. _group_link_classes:
 
 Link classes
 ------------
diff --git a/docs/whatsnew/3.11.rst b/docs/whatsnew/3.11.rst
@@ -1,18 +1,36 @@
+What's new in h5py 3.11
+=======================
+
 New features
 ------------
 
-* h5py is now compatible with Numpy 2.0 (:pr:`2401`).
-* Add methods `visit_links` and `visititems_links` that include links when visiting groups.
+* h5py is now compatible with Numpy 2.0 (:pr:`2329`, :pr:`2401`).
+* New methods :meth:`.Group.visit_links` and :meth:`.Group.visititems_links`
+  that include links when visiting groups (:pr:`2360`).
 
 Exposing HDF5 functions
 -----------------------
 
 * Exposes remaining information from `H5O_info_t` struct such as access, modification, change, and
-birth time. Also exposes field providing number of attributes attached to an object. Expands object
-header metadata struct `H5O_hdr_info_t`, `hdr` field of `H5O_info_t`, to provide number of chunks and
-flags set for object header. Lastly, adds `meta_size` field from `H5O_info_t` struct that provides
-two fields, `attr` which is the storage overhead of any attached attributes, and `obj` which is
-storage overhead required for chunk storage. The last two fields added can be useful for determining
-the storage overhead incurred from various data layout/chunked strategies, and for obtaining information
-such as that provided by `h5stat`.
+  birth time (:pr:`2358`). Also exposes field providing number of attributes attached to an object. Expands object
+  header metadata struct `H5O_hdr_info_t`, `hdr` field of `H5O_info_t`, to provide number of chunks and
+  flags set for object header. Lastly, adds `meta_size` field from `H5O_info_t` struct that provides
+  two fields, `attr` which is the storage overhead of any attached attributes, and `obj` which is
+  storage overhead required for chunk storage. The last two fields added can be useful for determining
+  the storage overhead incurred from various data layout/chunked strategies, and for obtaining information
+  such as that provided by `h5stat`.
+
+Bug fixes
+---------
+
+* :meth:`~.Dataset.iter_chunks()` now behaves correctly with a selection
+  (:pr:`2381`).
+* HDF5 allows external datasets (with the data stored in a separate file) to be
+  expandable along the first dimension. Such datasets can now be created
+  through h5py by passing a ``maxshape=`` parameter (:pr:`2398`).
+
+Building h5py
+-------------
 
+* h5py can now be built with Cython 3.x (:pr:`2345`).
+* Fixed some errors compiling with GCC 14 (:pr:`2380`, :pr:`2382`).
