summaryrefslogtreecommitdiffstats
path: root/man/sd_bus_call_method.xml
diff options
context:
space:
mode:
authorDaan De Meyer <daan.j.demeyer@gmail.com>2020-03-17 21:52:30 +0100
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2020-03-18 10:45:14 +0100
commit953ee402cba52518f57105ae9c3c630d8a421f00 (patch)
tree46f2b2100e9e5803f5b1758a0404d308b58c840a /man/sd_bus_call_method.xml
parentMerge pull request #15143 from ssahani/networkctl-tunnel-geneve (diff)
downloadsystemd-953ee402cba52518f57105ae9c3c630d8a421f00.tar.xz
systemd-953ee402cba52518f57105ae9c3c630d8a421f00.zip
sd-bus: sd_bus_call/sd_bus_call_async_docs + cleanups.
Diffstat (limited to 'man/sd_bus_call_method.xml')
-rw-r--r--man/sd_bus_call_method.xml13
1 files changed, 7 insertions, 6 deletions
diff --git a/man/sd_bus_call_method.xml b/man/sd_bus_call_method.xml
index 1565bab82d..de29ac9610 100644
--- a/man/sd_bus_call_method.xml
+++ b/man/sd_bus_call_method.xml
@@ -20,7 +20,8 @@
<refname>sd_bus_call_method</refname>
<refname>sd_bus_call_method_async</refname>
- <refpurpose>Invoke a D-Bus method call</refpurpose>
+ <refpurpose>Initialize a bus message object and invoke the corresponding D-Bus method call
+ </refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -59,15 +60,15 @@
<refsect1>
<title>Description</title>
- <para><function>sd_bus_call_method()</function> is a convenience function for calling a D-Bus
- method. It combines the
+ <para><function>sd_bus_call_method()</function> is a convenience function for initializing a
+ bus message object and calling the corresponding D-Bus method. It combines the
<citerefentry><refentrytitle>sd_bus_message_new_method_call</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>sd_bus_message_append</refentrytitle><manvolnum>3</manvolnum></citerefentry> and
<citerefentry><refentrytitle>sd_bus_call</refentrytitle><manvolnum>3</manvolnum></citerefentry>
functions into a single function call.</para>
- <para><function>sd_bus_call_method_async()</function> is a convenience function for calling a
- D-Bus method asynchronously. It combines the
+ <para><function>sd_bus_call_method_async()</function> is a convenience function for initializing
+ a bus message object and calling the corresponding D-Bus method asynchronously. It combines the
<citerefentry><refentrytitle>sd_bus_message_new_method_call</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>sd_bus_message_append</refentrytitle><manvolnum>3</manvolnum></citerefentry> and
<citerefentry><refentrytitle>sd_bus_call_async</refentrytitle><manvolnum>3</manvolnum></citerefentry>
@@ -77,7 +78,7 @@
<refsect1>
<title>Return Value</title>
- <para>On success, these functions returns a non-negative integer. On failure, they return a
+ <para>On success, these functions return a non-negative integer. On failure, they return a
negative errno-style error code.</para>
<refsect2 id='errors'>