doc: avoid gi-docgen linking syntax for non-doc comments (libvips#4506)

kleisauke · web-flow · commit da92837f3cf2 · 2025-05-10T14:00:03.000+01:00
diff --git a/libvips/iofuncs/image.c b/libvips/iofuncs/image.c
@@ -1523,7 +1523,7 @@ vips_image_preeval(VipsImage *image)
 
 		/* For vips7 compat, we also have to make sure ->time on the
 		 * image that was originally marked with
-		 * [method@Image.set_progress] is valid.
+		 * vips_image_set_progress() is valid.
 		 */
 		(void) vips_progress_add(image->progress_signal);
 
@@ -2655,7 +2655,7 @@ vips_image_write(VipsImage *image, VipsImage *out)
 	 *
 	 * If it's not partial, perhaps a file we write to or a memory image,
 	 * we need to break any links between @image and @out created by
-	 * [method@Image.pipelinev].
+	 * vips_image_pipelinev().
 	 */
 	if (vips_image_ispartial(out)) {
 		vips_object_local(out, image);
@@ -3223,7 +3223,7 @@ vips_image_write_line(VipsImage *image, int ypos, VipsPel *linebuffer)
 			return -1;
 
 		/* Always clear kill before we start looping. See the
-		 * call to [method@Image.iskilled] below.
+		 * call to vips_image_iskilled() below.
 		 */
 		vips_image_set_kill(image, FALSE);
 		vips_image_write_prepare(image);
@@ -3469,7 +3469,7 @@ vips_image_wio_input(VipsImage *image)
 		g_object_unref(t1);
 
 		/* We need to zap any start/gen/stop callbacks. If we don't,
-		 * calling [method@Region.prepare_to] later to read from this
+		 * calling vips_region_prepare_to() later to read from this
 		 * image will fail, since it will think it needs to create the
 		 * image, not read from it.
 		 */
@@ -3553,7 +3553,7 @@ vips__image_wio_output(VipsImage *image)
 		 *
 		 * We used to check that ->data was null and warn about
 		 * writing twice, but we no longer insist that this is called
-		 * before [method@Image.write_prepare], so we can't do that any
+		 * before vips_image_write_prepare(), so we can't do that any
 		 * more.
 		 */
 		break;
diff --git a/libvips/iofuncs/object.c b/libvips/iofuncs/object.c
@@ -933,7 +933,7 @@ vips_object_dispose_argument(VipsObject *object, GParamSpec *pspec,
 
 /* Free all args on this object which may be holding resources.
  *
- * Note that this is not the same as [method@Object.unref_outputs]. That
+ * Note that this is not the same as vips_object_unref_outputs(). That
  * looks for output objects which may have been created during _build() which
  * hold refs to this object and unrefs them.
  *
diff --git a/libvips/iofuncs/operation.c b/libvips/iofuncs/operation.c
@@ -1425,7 +1425,7 @@ vips_call_argv_output(VipsObject *object,
  * the GOption parser already, see above.
  *
  * We don't create the operation, so we must not unref it. The caller must
- * unref on error too. The caller must also call [method@Object.unref_outputs] on
+ * unref on error too. The caller must also call vips_object_unref_outputs() on
  * all code paths.
  */
 int
diff --git a/libvips/iofuncs/region.c b/libvips/iofuncs/region.c
@@ -1799,7 +1799,7 @@ vips_region_prepare_to(VipsRegion *reg,
 
 	/* clip r first against the size of reg->im, then again against the
 	 * memory we have available to write to on dest. Just like
-	 * [method@Region.region]
+	 * vips_region_region()
 	 */
 	image.top = 0;
 	image.left = 0;

Original file line number	Diff line number	Diff line change
`@@ -933,7 +933,7 @@ vips_object_dispose_argument(VipsObject object, GParamSpec pspec,`
`933`	`933`
`934`	`934`	`/* Free all args on this object which may be holding resources.`
`935`	`935`	`*`
`936`		`- * Note that this is not the same as [method@Object.unref_outputs]. That`
	`936`	`+ * Note that this is not the same as vips_object_unref_outputs(). That`
`937`	`937`	`* looks for output objects which may have been created during _build() which`
`938`	`938`	`* hold refs to this object and unrefs them.`
`939`	`939`	`*`
Original file line number	Diff line number	Diff line change
`@@ -1425,7 +1425,7 @@ vips_call_argv_output(VipsObject *object,`
`1425`	`1425`	`* the GOption parser already, see above.`
`1426`	`1426`	`*`
`1427`	`1427`	`* We don't create the operation, so we must not unref it. The caller must`
`1428`		`- * unref on error too. The caller must also call [method@Object.unref_outputs] on`
	`1428`	`+ * unref on error too. The caller must also call vips_object_unref_outputs() on`
`1429`	`1429`	`* all code paths.`
`1430`	`1430`	`*/`
`1431`	`1431`	`int`