From ce199d12e9a88286271dec6f22cd2c61f1cd7f54 Mon Sep 17 00:00:00 2001
From: Luca Boccassi <bluca@debian.org>
Date: Thu, 30 Mar 2023 17:03:50 +0100
Subject: man: add example for sd_bus_call_method

---
 man/sd_bus_call_method.xml | 13 +++++++++++++
 1 file changed, 13 insertions(+)

(limited to 'man/sd_bus_call_method.xml')

diff --git a/man/sd_bus_call_method.xml b/man/sd_bus_call_method.xml
index 762ea11c01..7b525558d7 100644
--- a/man/sd_bus_call_method.xml
+++ b/man/sd_bus_call_method.xml
@@ -126,6 +126,19 @@
 
   <xi:include href="libsystemd-pkgconfig.xml" />
 
+  <refsect1>
+    <title>Examples</title>
+
+    <example>
+      <title>Make a call to a D-Bus method that takes a single parameter</title>
+
+      <programlisting><xi:include href="print-unit-path-call-method.c" parse="text" /></programlisting>
+      <para>This defines a minimally useful program that will open a connection to the bus, call a method,
+      wait for the reply, and finally extract and print the answer. It does error handling and proper
+      memory management.</para>
+    </example>
+  </refsect1>
+
   <refsect1>
     <title>See Also</title>
 
-- 
cgit v1.2.1