im_scaleps() gtkdoc

libvips/conversion/im_scale.c

@@ -66,7 +66,7 @@
  * as unsigned 8-bit, scaled so that the maximum value is 255 and the
  * minimum is zero.
  *
- * See also: im_clip2fmt().
+ * See also: im_clip2fmt(), im_scaleps().
  *
  * Returns: 0 on success, -1 on error
  */

libvips/conversion/im_scaleps.c

@@ -1,11 +1,4 @@
-/* @(#) transform with log10(1.0 + pow(x, 0.25)) + .5, then scale so max
- * @(#) == 255.
- * @(#)
- * @(#) int im_scaleps(in, out)
- * @(#) IMAGE *in, *out;
- * @(#)
- * @(#) All functions return 0 on success and -1 on error
- * @(#)
+/* im_scaleps
  *
  * Copyright: 1990, N. Dessipris.
  *
@@ -21,6 +14,8 @@
  * 11/7/02 JC
  *	- rewritten ... got rid of the stuff for handling -ves, never used
  *	  (and was broken anyway)
+ * 1/2/10
+ * 	- gtkdoc
  */
 
 /*
@@ -64,7 +59,17 @@
 #include <dmalloc.h>
 #endif /*WITH_DMALLOC*/
 
-/* Scale, as noted above.
+/**
+ * im_scaleps:
+ * @in: input image
+ * @out: output image
+ *
+ * Scale a power spectrum. Transform with log10(1.0 + pow(x, 0.25)) + .5, 
+ * then scale so max == 255.
+ *
+ * See also: im_scale().
+ *
+ * Returns: 0 on success, -1 on error
  */
 int 
 im_scaleps( IMAGE *in, IMAGE *out )