small autodocs cleanup, regen for 8.17

Don't make autodoc wrappers for `composite` and `DemandStyle`, regen for
8.17.

Author: jcupitt

CHANGELOG.md

@@ -4,6 +4,9 @@ All notable changes to `php-vips` will be documented in this file.
 
 ## master
 
+- suppress autodoc of `composite` and `DemandStyle` [jcupitt]
+- update docs for 8.17 [jcupitt]
+
 ## 2.5.0 - 2025-04-04
 
 - add addLibraryPath() to let users set their libvips location [kleisauke]

examples/generate_phpdoc.py

@@ -225,6 +225,7 @@ def add_nickname(gtype, a, b):
 
     # these have hand-written methods, don't autodoc them
     no_generate = [
+        'composite',
         'bandjoin',
         'bandrank',
         'ifthenelse',
@@ -287,6 +288,10 @@ def add_enum(gtype, a, b):
 
     type_map(type_from_name('GEnum'), add_enum)
 
+    # Filter internal enums
+    blacklist = ['VipsDemandStyle']
+    all_enums = [name for name in all_enums if name not in blacklist]
+
     for name in all_enums:
         gtype = type_from_name(name)
         php_name = remove_prefix(name)

src/DemandStyle.php

@@ -147,8 +147,6 @@
  * @method Image complexget(string $get, array $options = []) Get a component from a complex image.
  *     @see OperationComplexget for possible values for $get
  *     @throws Exception
- * @method static Image composite(Image[]|Image $in, integer[]|integer $mode, array $options = []) Blend an array of images with an array of blend modes.
- *     @throws Exception
  * @method Image composite2(Image $overlay, string $mode, array $options = []) Blend a pair of images with a blend mode.
  *     @see BlendMode for possible values for $mode
  *     @throws Exception
@@ -382,9 +380,9 @@
  *     @throws Exception
  * @method static Image logmat(float $sigma, float $min_ampl, array $options = []) Make a Laplacian of Gaussian image.
  *     @throws Exception
- * @method static Image magickload(string $filename, array $options = []) Load file with ImageMagick.
+ * @method static Image magickload(string $filename, array $options = []) Load file with ImageMagick7.
  *     @throws Exception
- * @method static Image magickload_buffer(string $buffer, array $options = []) Load buffer with ImageMagick.
+ * @method static Image magickload_buffer(string $buffer, array $options = []) Load buffer with ImageMagick7.
  *     @throws Exception
  * @method void magicksave(string $filename, array $options = []) Save file with ImageMagick.
  *     @throws Exception
@@ -503,7 +501,9 @@
  *     @throws Exception
  * @method static Image ppmload(string $filename, array $options = []) Load ppm from file.
  *     @throws Exception
- * @method static Image ppmload_source(Source $source, array $options = []) Load ppm base class.
+ * @method static Image ppmload_buffer(string $buffer, array $options = []) Load ppm from buffer.
+ *     @throws Exception
+ * @method static Image ppmload_source(Source $source, array $options = []) Load ppm from source.
  *     @throws Exception
  * @method void ppmsave(string $filename, array $options = []) Save image to ppm file.
  *     @throws Exception