add shutdown() and update install notes

Author: jcupitt

CHANGELOG.rst

@@ -3,6 +3,8 @@
 - drop support for Python 2.7, require Python >= 3.7 [kleisauke]
 - migrate to `pyproject.toml` [kleisauke]
 - fix a small memleak in `write_to_buffer()` [kleisauke]
+- add `[binary]` install option [kleisauke]
+- add `shutdown()` 
 
 ## Version 2.2.3 (released 28 April 2024)
 

README.rst

@@ -78,8 +78,11 @@ with:
     $ pip install "pyvips[binary]"
 
 This installs a self-contained package with the most commonly needed
-libraries. If your platform is unsupported or the pre-built binary is
-unsuitable, you can install libvips globally instead.
+libraries. It should just work on most common platforms, including Linux,
+Window and macOS, with x64 and ARM CPUs.
+
+If your platform is unsupported or the pre-built binary is
+unsuitable, you can install libvips separately instead.
 
 Local installation
 ------------------
@@ -191,6 +194,7 @@ Local user install:
 
 .. code-block:: shell
 
+    $ pip install pyvips-binary==8.16.0
     $ pip3 install -e .
     $ pypy -m pip --user -e .
 

pyvips/voperation.py

@@ -540,6 +540,11 @@ def add_name(gtype, a, b):
             print('   ' + docstr)
 
 
+def shutdown():
+    """Shut libvips down."""
+    vips_lib.vips_shutdown()
+
+
 def cache_set_max(mx):
     """Set the maximum number of operations libvips will cache."""
     vips_lib.vips_cache_set_max(mx)