Refactor shape masking

docs/src/whatsnew/latest.rst

@@ -34,6 +34,10 @@ This document explains the changes made to Iris for this release
    horizontal grid.
    (:issue:`5770`, :pull:`6581`)
 
+#. `@hsteptoe <https://github.com/hsteptoe>`_ and `@...`_ (reviewer) extended :func:`iris.util.mask_cube_from_shapefile`
+   to handle additional Point and Line shape types.  This change also facilitates the use of shapefiles that 
+   use a different projection system to the cube that they are being applied to, and makes performance improvements
+   to the mask weighting calculations. (:issue:`6126`, :pull:`6129`).  
 
 🐛 Bugs Fixed
 =============
@@ -65,15 +69,20 @@ This document explains the changes made to Iris for this release
 🔗 Dependencies
 ===============
 
-#. N/A
-
+#. `@hsteptoe <https://github.com/hsteptoe>`_ added `rasterio <https://rasterio.readthedocs.io/en/stable/index.html>`_ 
+   and `affiine <https://affine.readthedocs.io/en/latest/>`_ as a dependency for :func:`iris.util.mask_cube_from_shapefile`. 
+   This is to support the new functionality of handling additional shapefiles and projections. (:issue:`6126`, :pull:`6129`)
 
 📚 Documentation
 ================
 
 #. `@rcomer`_ updated all Cartopy references to point to the new location at
    https://cartopy.readthedocs.io (:pull:`6636`)
 
+#. `@hsteptoe <https://github.com/hsteptoe>`_ added additional worked examples
+   to the :ref:`iris.util.mask_cube_from_shapefile` documentation, to demonstrate
+   how to use the function with different types of shapefiles. (:pull:`6129`)
+
 
 💼 Internal
 ===========