From 5aa818039230a08e0af1c6351de4794de8ebb778 Mon Sep 17 00:00:00 2001
From: Luca Boccassi <bluca@debian.org>
Date: Sun, 31 Mar 2024 14:22:54 +0100
Subject: [PATCH] man: document that using sd_journal APIs might cause dlopen
 to happen

---
 man/sd-journal.xml | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/man/sd-journal.xml b/man/sd-journal.xml
index d143cb4a0f7..5908f98e68a 100644
--- a/man/sd-journal.xml
+++ b/man/sd-journal.xml
@@ -86,6 +86,17 @@
     — are fully thread-safe and may be called from multiple threads in parallel.</para>
   </refsect1>
 
+  <refsect1>
+    <title>Optional dependencies</title>
+
+    <para>Depending on which build-time options are enabled, functions that operate on
+    <structname>sd_journal</structname> objects might cause optional shared libraries to be dynamically
+    loaded via
+    <citerefentry project='man7'><refentrytitle>dlopen</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
+    such as decompression libraries (xz, lz4, zstd) or cryptographic libraries (gcrypt).
+    </para>
+  </refsect1>
+
   <xi:include href="libsystemd-pkgconfig.xml" />
 
   <refsect1>
-- 
2.47.3