stuff

ChangeLog

@@ -56,6 +56,7 @@
 - callback gtkdocs
 - error gtkdocs
 - removed printlines tool, vips2csv is much better
+- removed other useless tools as well: debugim, binfile
 
 25/3/09 started 7.18.0
 - revised version numbers

TODO

@@ -1,4 +1,8 @@
-- im_close(), im_local() etc. need docs still
+- image.h/im_invalidate() needs docs
+
+- started region.h
+
+  
 
 - more stuff from util.c? too much to do it all now
 

libvips/include/vips/image.h

@@ -330,7 +330,7 @@ VipsImage *im_open( const char *filename, const char *mode );
 
 int im_close( VipsImage *im );
 
-void im_invalidate( IMAGE *im );
+void im_invalidate( VipsImage *im );
 
 #ifdef __cplusplus
 }

libvips/include/vips/private.h

@@ -84,7 +84,7 @@ typedef struct {
 
 /* window manager.
  */
-im_window_t *im_window_ref( IMAGE *im, int top, int height );
+im_window_t *im_window_ref( struct _VipsImage *im, int top, int height );
 int im_window_unref( im_window_t *window );
 void im_window_print( im_window_t *window );
 

libvips/iofuncs/im_close.c

@@ -1,19 +1,4 @@
-/* @(#) Frees all resources associated with IMAGE, and frees the memory
+/* im_close.c --- close an image
- * @(#) occupied by IMAGE.
- * @(#)
- * @(#) int 
- * @(#) im_close( image )
- * @(#) IMAGE *image;
- * @(#)
- * @(#) As above, but just free resources attached to IMAGE. After call, IMAGE
- * @(#) is as if im_init() had just been called. Useful for closing and
- * @(#) re-opening as another image type. See im_piocheck() etc.
- * @(#)
- * @(#) int 
- * @(#) im__close( image )
- * @(#) IMAGE *image;
- * @(#)
- * @(#) Returns 0 on success and 1 on error.
  *
  * Copyright: Nicos Dessipris
  * Written on: 12/04/1990
@@ -63,6 +48,8 @@
  * 	  can now write close callbacks that unlink() temporary files
  * 	- use preclose callbacks if you want to run before resources are
  * 	  released
+ * 6/10/09
+ * 	- gtkdoc comment
  */
 
 /*
@@ -255,7 +242,18 @@ im__close( IMAGE *im )
 	return( result );
 }
 
-/* Free resources and close descriptor.
+/**
+ * im_close:
+ * @im: image to close
+ *
+ * Frees all resources associated with @im. 
+ *
+ * If there are open #REGION s on @im, close is delayed until the last region
+ * is freed.
+ *
+ * See also: im_open().
+ *
+ * Returns: 0 on success and 1 on error.
  */
 int 
 im_close( IMAGE *im )