From: Karel Zak <kzak@redhat.com>
Date: Tue, 14 Jul 2026 12:28:27 +0000 (+0200)
Subject: docs: update libsmartcols gtk-doc configuration
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=5ebed901ccc5bce19dc554b641a053ad3b8f8803;p=thirdparty%2Futil-linux.git

docs: update libsmartcols gtk-doc configuration

- add api-index entries for versions 2.41, 2.42 and 2.43
- fix wrap_nextchunk() -> @wrap_nextchunk in doc comment to avoid
  broken cross-reference link

Signed-off-by: Karel Zak <kzak@redhat.com>
---

diff --git a/libsmartcols/docs/Makefile.am b/libsmartcols/docs/Makefile.am
index e8a7600e9..24bf94759 100644
--- a/libsmartcols/docs/Makefile.am
+++ b/libsmartcols/docs/Makefile.am
@@ -57,7 +57,7 @@ EXTRA_HFILES=
 
 # Header files to ignore when scanning. Use base file name, no paths
 # e.g. IGNORE_HFILES=gtkdebug.h gtkintl.h
-IGNORE_HFILES=smartcolsP.h
+IGNORE_HFILES=smartcolsP.h filter-scanner.c filter-scanner.h filter-parser.c filter-parser.h
 
 # Images to copy into HTML directory.
 # e.g. HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png
diff --git a/libsmartcols/docs/libsmartcols-docs.xml b/libsmartcols/docs/libsmartcols-docs.xml
index bd5518273..25b87571d 100644
--- a/libsmartcols/docs/libsmartcols-docs.xml
+++ b/libsmartcols/docs/libsmartcols-docs.xml
@@ -95,4 +95,16 @@ available from https://www.kernel.org/pub/linux/utils/util-linux/.
     <title>Index of new symbols in 2.40</title>
     <xi:include href="xml/api-index-2.40.xml"><xi:fallback /></xi:include>
   </index>
+  <index role="2.41">
+    <title>Index of new symbols in 2.41</title>
+    <xi:include href="xml/api-index-2.41.xml"><xi:fallback /></xi:include>
+  </index>
+  <index role="2.42">
+    <title>Index of new symbols in 2.42</title>
+    <xi:include href="xml/api-index-2.42.xml"><xi:fallback /></xi:include>
+  </index>
+  <index role="2.43">
+    <title>Index of new symbols in 2.43</title>
+    <xi:include href="xml/api-index-2.43.xml"><xi:fallback /></xi:include>
+  </index>
 </book>
diff --git a/libsmartcols/src/column.c b/libsmartcols/src/column.c
index 2ae4c6227..a30262eee 100644
--- a/libsmartcols/src/column.c
+++ b/libsmartcols/src/column.c
@@ -689,7 +689,7 @@ int scols_column_set_cmpfunc(struct libscols_column *cl,
  * the size itself.
  *
  * The wrap functions do not work directly with cell data, but with buffer used
- * by library to compose output data. The wrap_nextchunk() function can access
+ * by library to compose output data. The @wrap_nextchunk function can access
  * additional details about wrap data by scols_column_get_wrap_data().
  *
  * Returns: 0, a negative value in case of an error.