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

docs: update libmount gtk-doc configuration

- set SCAN_OPTIONS with --deprecated-guards="LIBMOUNT_DISABLE_DEPRECATED"
- add monitor.h to IGNORE_HFILES (private header)
- add statmount.xml section include to libmount-docs.xml
- add api-index entries for versions 2.42 and 2.43
- remove api-index entries for non-existent versions 2.37 and 2.39
- add missing symbols to libmount-sections.txt (MNT_ERR_ONLYONCE,
  MNT_ERR_CHOWN, MNT_ERR_CHMOD, MNT_ERR_IDMAP, MNT_ERR_EXEC,
  MNT_EX_EXEC, MNT_MS_VERITY_ON_CORRUPTION, MS_NOSYMFOLLOW,
  MNT_NOFSTAB, MNT_SUPERBLOCK)

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

diff --git a/libmount/docs/Makefile.am b/libmount/docs/Makefile.am
index 18b036fb0..cb1e8a558 100644
--- a/libmount/docs/Makefile.am
+++ b/libmount/docs/Makefile.am
@@ -28,7 +28,7 @@ SCANGOBJ_OPTIONS=
 
 # Extra options to supply to gtkdoc-scan.
 # e.g. SCAN_OPTIONS=--deprecated-guards="GTK_DISABLE_DEPRECATED"
-SCAN_OPTIONS=
+SCAN_OPTIONS=--deprecated-guards="LIBMOUNT_DISABLE_DEPRECATED"
 
 # Extra options to supply to gtkdoc-mkdb.
 # e.g. MKDB_OPTIONS=--sgml-mode --output-format=xml
@@ -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=mountP.h
+IGNORE_HFILES=mountP.h monitor.h
 
 # Images to copy into HTML directory.
 # e.g. HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png
diff --git a/libmount/docs/libmount-docs.xml b/libmount/docs/libmount-docs.xml
index 9a2c1b947..484ea791a 100644
--- a/libmount/docs/libmount-docs.xml
+++ b/libmount/docs/libmount-docs.xml
@@ -38,6 +38,7 @@ available from https://www.kernel.org/pub/linux/utils/util-linux/.
     <title>Files parsing</title>
     <xi:include href="xml/table.xml"/>
     <xi:include href="xml/fs.xml"/>
+    <xi:include href="xml/statmount.xml"/>
   </part>
   <part>
     <title>Tables management</title>
@@ -83,18 +84,10 @@ available from https://www.kernel.org/pub/linux/utils/util-linux/.
     <title>Index of new symbols in 2.35</title>
     <xi:include href="xml/api-index-2.35.xml"><xi:fallback /></xi:include>
   </index>
-  <index role="2.37">
-    <title>Index of new symbols in 2.37</title>
-    <xi:include href="xml/api-index-2.37.xml"><xi:fallback /></xi:include>
-  </index>
   <index role="2.38">
     <title>Index of new symbols in 2.38</title>
     <xi:include href="xml/api-index-2.38.xml"><xi:fallback /></xi:include>
   </index>
-  <index role="2.39">
-    <title>Index of new symbols in 2.39</title>
-    <xi:include href="xml/api-index-2.39.xml"><xi:fallback /></xi:include>
-  </index>
   <index role="2.40">
     <title>Index of new symbols in 2.40</title>
     <xi:include href="xml/api-index-2.40.xml"><xi:fallback /></xi:include>
@@ -103,4 +96,12 @@ available from https://www.kernel.org/pub/linux/utils/util-linux/.
     <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/libmount/docs/libmount-sections.txt b/libmount/docs/libmount-sections.txt
index e9683b06f..ce31ba1f2 100644
--- a/libmount/docs/libmount-sections.txt
+++ b/libmount/docs/libmount-sections.txt
@@ -131,6 +131,11 @@ MNT_ERR_NOSOURCE
 MNT_ERR_LOOPOVERLAP
 MNT_ERR_LOCK
 MNT_ERR_NAMESPACE
+MNT_ERR_ONLYONCE
+MNT_ERR_CHOWN
+MNT_ERR_CHMOD
+MNT_ERR_IDMAP
+MNT_ERR_EXEC
 <SUBSECTION>
 MNT_EX_SUCCESS
 MNT_EX_USAGE
@@ -140,6 +145,7 @@ MNT_EX_USER
 MNT_EX_FILEIO
 MNT_EX_FAIL
 MNT_EX_SOMEOK
+MNT_EX_EXEC
 </SECTION>
 
 <SECTION>
@@ -175,6 +181,7 @@ MNT_MS_FEC_DEVICE
 MNT_MS_FEC_OFFSET
 MNT_MS_FEC_ROOTS
 MNT_MS_ROOT_HASH_SIG
+MNT_MS_VERITY_ON_CORRUPTION
 <SUBSECTION>
 MS_BIND
 MS_DIRSYNC
@@ -203,6 +210,7 @@ MS_STRICTATIME
 MS_SYNCHRONOUS
 MS_UNBINDABLE
 MS_LAZYTIME
+MS_NOSYMFOLLOW
 </SECTION>
 
 <SECTION>
@@ -290,7 +298,6 @@ mnt_fs_strdup_options
 mnt_fs_streq_srcpath
 mnt_fs_streq_target
 mnt_fs_to_mntent
-mnt_fs_fetch_statmount
 mnt_fs_get_ns
 mnt_fs_set_ns
 mnt_new_fs
@@ -345,6 +352,8 @@ MNT_INVERT
 MNT_NOMTAB
 MNT_PREFIX
 MNT_NOHLPS
+MNT_NOFSTAB
+MNT_SUPERBLOCK
 </SECTION>
 
 <SECTION>