From: Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Date: Tue, 12 Apr 2022 09:30:28 +0000 (+0200)
Subject: man: say libudev should not be used for new projects
X-Git-Tag: v251-rc2~136^2~5
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=69e6a4697039edf2e3f37c441bd4ee30c736620d;p=thirdparty%2Fsystemd.git

man: say libudev should not be used for new projects
---

diff --git a/man/libudev.xml b/man/libudev.xml
index 4b87962fc0d..8632ea94204 100644
--- a/man/libudev.xml
+++ b/man/libudev.xml
@@ -37,8 +37,10 @@
   <refsect1>
     <title>Description</title>
 
-    <para><filename>libudev.h</filename> provides APIs to introspect
-    and enumerate devices on the local system.</para>
+    <para><filename>libudev.h</filename> provides an API to introspect and enumerate devices on the local
+    system. This library is supported, but should not be used in new projects. Please see
+    <citerefentry><refentrytitle>sd-device</refentrytitle><manvolnum>3</manvolnum></citerefentry> for an
+    equivalent replacement with a more modern API.</para>
 
     <para>All functions require a libudev context to operate. This
     context can be create via