add missing flag and enum docs

We'd not updated these for quite a while!

I used the automatically-generated python enum docs as a guide.

Author: jcupitt

CHANGELOG.md

@@ -4,6 +4,7 @@
 
 * improve NULL pointer handling [dloebl]
 * improve GFlags argument handling [jcupitt]
+* add missing flags and enums [jcupitt]
 
 ## Version 2.2.4 (2025-06-05)
 

lib/vips/combine.rb

@@ -0,0 +1,12 @@
+module Vips
+  # How to combine values, see for example {Image#compass}. 
+  #
+  # * `:max` take the maximum of the possible values
+  # * `:sum` sum all the values
+  # * `:min` take the minimum value
+
+  class Combine < Symbol
+  end
+end
+
+

lib/vips/fail_on.rb

@@ -0,0 +1,17 @@
+module Vips
+  # How sensitive loaders are to errors, from never stop (very insensitive), 
+  # to stop on the smallest warning (very sensitive).
+  #
+  # Each implies the ones before it, so `:error` implies `:truncated`, for
+  # example.
+  #
+  # *   `:none` never stop
+  # *   `:truncated` stop on image truncated, nothing else
+  # *   `:error` stop on serious error or truncation
+  # *   `:warning` stop on anything, even warnings
+
+  class FailOn < Symbol
+  end
+end
+
+

lib/vips/foreign_dz_container.rb

@@ -0,0 +1,16 @@
+module Vips
+  # The container format to use
+  #
+  # *   `:fs` write tiles to the filesystem
+  # *   `:zip` write tiles to a zip file
+  # *   `:szi` write to a szi file
+
+  class ForeignDzContainer < Symbol
+  end
+end
+
+
+
+
+
+

lib/vips/foreign_dz_depth.rb

@@ -0,0 +1,15 @@
+module Vips
+  # How many pyramid layers to create.
+  #
+  # *   `:onepixel` create layers down to 1x1 pixel
+  # *   `:onetile` create layers down to 1x1 tile
+  # *   `:one` only create a single layer
+
+  class ForeignDzDepth < Symbol
+  end
+end
+
+
+
+
+

lib/vips/foreign_dz_layout.rb

@@ -0,0 +1,16 @@
+module Vips
+  # What directory layout and metadata standard to use.
+  #
+  # *   `:dz` use DeepZoom directory layout
+  # *   `:zoomify` use Zoomify directory layout
+  # *   `:google` use Google maps directory layout
+  # *   `:iiif` use IIIF v2 directory layout
+  # *   `:iiif3` use IIIF v3 directory layout
+
+  class ForeignDzLayout < Symbol
+  end
+end
+
+
+
+

lib/vips/foreign_heif_compression.rb

@@ -0,0 +1,16 @@
+module Vips
+  # The compression format to use inside a HEIF container
+  #
+  # *   `:hevc` x265
+  # *   `:avc` x264
+  # *   `:jpeg` jpeg
+  # *   `:av1` aom
+
+  class ForeignHeifCompression < Symbol
+  end
+end
+
+
+
+
+

lib/vips/foreign_heif_encoder.rb

@@ -0,0 +1,17 @@
+module Vips
+  # The selected encoder to use.
+  #
+  # *   `:auto` auto
+  # *   `:rav1e` RAV1E
+  # *   `:svt` SVT-AV1
+  # *   `:x265` x265
+
+  class ForeignHeifEncoder < Symbol
+  end
+end
+
+
+
+
+
+

lib/vips/foreign_ppm_format.rb

@@ -0,0 +1,14 @@
+module Vips
+  # The netpbm file format to save as.
+  #
+  # *   `:pbm` portable bitmap
+  # *   `:pgm` portable greymap
+  # *   `:ppm` portable pixmap
+  # *   `:pfm` portable float map
+  # *   `:pnm` portable anymap
+
+  class ForeignPpmFormat < Symbol
+  end
+end
+
+

lib/vips/foreign_subsample.rb

@@ -0,0 +1,13 @@
+module Vips
+  # Set subsampling mode.
+  #
+  # *   `:auto` prevent subsampling when quality >= 90
+  # *   `:on` always perform subsampling
+  # *   `:off` never perform subsampling
+
+  class ForeignSubsample < Symbol
+  end
+end
+
+
+