man: say libudev should not be used for new projects

diff --git a/man/libudev.xml b/man/libudev.xml
index 4b87962fc0d231dcdc88abb96ebd0832d2f03747..8632ea94204266926733f2ff325bc6f6804bb073 100644 (file)
--- 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