docs update

TODO

@@ -1,10 +1,37 @@
+- need to be able to select savers by suffix, and set options
+
+  eg.
+
+	  vips_foreign_save_buffer( VipsImage *in, void **buf, size_t *len, 
+		const char *format, ... )
+
+  format can be
+
+  	.jpg
+	.jpg[Q=80]
+
+  opt can be passed in the ... as well, overriding things set in the format
+
+
+  ... but foreign_class->suffs is set for eg. jpegsave_file and is how we pick
+  out savers from destination filenames, what can we use to pick buffer
+  savers?
+
+  need some new class member to do the lookup on? .suffs_buffer?
+
+- use this for dzsave_buffer 
+
+
+- vips_filename_suffix_match() is used by
+  vips_foreign_load_new_from_foreign_sub(), but it splits on ':' ... argh!
+
+  deprecate this thing and stop ':' split
+
+
+  
+
 - support 1/2/4 bit palette tiff with alpha
 
-- support ttiff read/write from buffer, see
-
-http://stackoverflow.com/questions/4624144/c-libtiff-read-and-save-file-from-and-to-memory
-
-
 - can we use postbuild elsewhere? look at use of "preclose" / "written", etc. 
 
 

libvips/foreign/foreign.c

@@ -87,10 +87,12 @@
  * the file name extension) with JPEG compression.
  *
  * |[
- * vips_foreign_save_options (my_image, "frank.tiff[compression=jpeg]");  
+ * vips_foreign_save_options (my_image, "frank.tiff[compression=jpeg]", NULL);  
  * ]|
  *
- * Is the same thing, but with the option in the filename.
+ * Is the same thing, but with the option in the filename. You can put
+ * name - value pairs after the filename as well: these will override any
+ * options set in the filename. 
  *
  * You can also invoke the operations directly, for example:
  *
@@ -108,9 +110,8 @@
  * transparently supported by vips_image_new_from_file() and friends.
  *
  * VIPS comes with VipsForeign for TIFF, JPEG, PNG, Analyze, PPM, OpenEXR, CSV,
- * Matlab, Radiance, RAW, FITS and VIPS. It also 
- * includes import filters which can
- * load with libMagick and with OpenSlide. 
+ * Matlab, Radiance, RAW, FITS, WebP and VIPS. It also includes import filters 
+ * which can load with libMagick and with OpenSlide. 
  */
 
 /**
@@ -159,7 +160,7 @@
  * Add a new loader to VIPS by subclassing #VipsForeignLoad. Subclasses need to 
  * implement at least @header().
  *
- * As a complete example, here's the code for the PNG loader, minus the actual
+ * As a complete example, here's code for a PNG loader, minus the actual
  * calls to libpng.
  *
  * |[