From: Osama Abdelkader <osama.abdelkader@gmail.com>
Date: Fri, 26 Sep 2025 18:34:53 +0000 (+0300)
Subject: man: add missing description for udev_enumerate_new functions
X-Git-Tag: v259-rc1~414
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=4f4641799e289ad5d0c149004972470ce7961551;p=thirdparty%2Fsystemd.git

man: add missing description for udev_enumerate_new functions

Add proper description section for udev_enumerate_new(), udev_enumerate_ref(),
and udev_enumerate_unref() functions. The description matches the source code
comments for consistency.

Signed-off-by: Osama Abdelkader <osama.abdelkader@gmail.com>
---

diff --git a/man/udev_enumerate_new.xml b/man/udev_enumerate_new.xml
index ba5fec9557e..8c34e12bee8 100644
--- a/man/udev_enumerate_new.xml
+++ b/man/udev_enumerate_new.xml
@@ -49,11 +49,16 @@
     </funcsynopsis>
   </refsynopsisdiv>
 
-  <!--<refsect1>
+  <refsect1>
     <title>Description</title>
 
-    <para>XXX: Add short description.</para>
-  </refsect1>-->
+    <para><function>udev_enumerate_new()</function> creates an enumeration context to scan /sys.</para>
+
+    <para><function>udev_enumerate_ref()</function> takes a reference of an enumeration context.</para>
+
+    <para><function>udev_enumerate_unref()</function> drops a reference of an enumeration context. If the refcount reaches zero,
+    all resources of the enumeration context will be released.</para>
+  </refsect1>
 
   <refsect1>
     <title>Return Value</title>