From e38953c5dfa302875c4578ad1222b114ee6eac69 Mon Sep 17 00:00:00 2001
From: Konrad Narewski <konradnarewski@gmail.com>
Date: Mon, 11 Nov 2024 18:08:05 +0100
Subject: [PATCH] docs: clarify descriptions for vips_extract_band docs (#4250)

---
 libvips/conversion/extract.c | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/libvips/conversion/extract.c b/libvips/conversion/extract.c
index 748f350fa5..fe7dedad40 100644
--- a/libvips/conversion/extract.c
+++ b/libvips/conversion/extract.c
@@ -459,7 +459,7 @@ vips_extract_band_init(VipsExtractBand *extract)
  * vips_extract_band: (method)
  * @in: input image
  * @out: (out): output image
- * @band: band to extract
+ * @band: index of first band to extract
  * @...: %NULL-terminated list of optional named arguments
  *
  * Optional arguments:
@@ -468,6 +468,8 @@ vips_extract_band_init(VipsExtractBand *extract)
  *
  * Extract a band or bands from an image. Extracting out of range is an error.
  *
+ * @n defaults to 1.
+ *
  * See also: vips_extract_area().
  *
  * Returns: 0 on success, -1 on error.