From: Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Date: Fri, 4 Mar 2022 14:23:17 +0000 (+0100)
Subject: man: fix formatting of macros in sd_bus_add_object
X-Git-Tag: v251-rc1~203^2~4
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=3c080282e928a7edfcdb74feb2139ef1ac6f2ad0;p=thirdparty%2Fsystemd.git

man: fix formatting of macros in sd_bus_add_object

docbook would convert the newline to a space before the first argument:
  SD_BUS_METHOD_WITH_ARGS( member, args, result, handler)

And we need each item in a separate <para>, otherwise they'll all be in
one line.
---

diff --git a/man/sd_bus_add_object.xml b/man/sd_bus_add_object.xml
index 54683e4f118..dcf9377ffdd 100644
--- a/man/sd_bus_add_object.xml
+++ b/man/sd_bus_add_object.xml
@@ -128,8 +128,7 @@
         <constant>SD_BUS_VTABLE_END</constant>
       </para>
       <para>
-        <constant>SD_BUS_METHOD_WITH_ARGS_OFFSET(
-        <replaceable>member</replaceable>,
+        <constant>SD_BUS_METHOD_WITH_ARGS_OFFSET(<replaceable>member</replaceable>,
         <replaceable>args</replaceable>,
         <replaceable>result</replaceable>,
         <replaceable>handler</replaceable>,
@@ -138,8 +137,7 @@
         </constant>
       </para>
       <para>
-        <constant>SD_BUS_METHOD_WITH_ARGS(
-        <replaceable>member</replaceable>,
+        <constant>SD_BUS_METHOD_WITH_ARGS(<replaceable>member</replaceable>,
         <replaceable>args</replaceable>,
         <replaceable>result</replaceable>,
         <replaceable>handler</replaceable>,
@@ -147,8 +145,7 @@
         </constant>
       </para>
       <para>
-        <constant>SD_BUS_METHOD_WITH_NAMES_OFFSET(
-        <replaceable>member</replaceable>,
+        <constant>SD_BUS_METHOD_WITH_NAMES_OFFSET(<replaceable>member</replaceable>,
         <replaceable>signature</replaceable>,
         <replaceable>in_names</replaceable>,
         <replaceable>result</replaceable>,
@@ -159,8 +156,7 @@
         </constant>
       </para>
       <para>
-        <constant>SD_BUS_METHOD_WITH_NAMES(
-        <replaceable>member</replaceable>,
+        <constant>SD_BUS_METHOD_WITH_NAMES(<replaceable>member</replaceable>,
         <replaceable>signature</replaceable>,
         <replaceable>in_names</replaceable>,
         <replaceable>result</replaceable>,
@@ -170,8 +166,7 @@
         </constant>
       </para>
       <para>
-        <constant>SD_BUS_METHOD_WITH_OFFSET(
-        <replaceable>member</replaceable>,
+        <constant>SD_BUS_METHOD_WITH_OFFSET(<replaceable>member</replaceable>,
         <replaceable>signature</replaceable>,
         <replaceable>result</replaceable>,
         <replaceable>handler</replaceable>,
@@ -180,8 +175,7 @@
         </constant>
       </para>
       <para>
-        <constant>SD_BUS_METHOD(
-        <replaceable>member</replaceable>,
+        <constant>SD_BUS_METHOD(<replaceable>member</replaceable>,
         <replaceable>signature</replaceable>,
         <replaceable>result</replaceable>,
         <replaceable>handler</replaceable>,
@@ -189,30 +183,26 @@
         </constant>
       </para>
       <para>
-        <constant>SD_BUS_SIGNAL_WITH_ARGS(
-        <replaceable>member</replaceable>,
+        <constant>SD_BUS_SIGNAL_WITH_ARGS(<replaceable>member</replaceable>,
         <replaceable>args</replaceable>,
         <replaceable>flags</replaceable>)
         </constant>
       </para>
       <para>
-        <constant>SD_BUS_SIGNAL_WITH_NAMES(
-        <replaceable>member</replaceable>,
+        <constant>SD_BUS_SIGNAL_WITH_NAMES(<replaceable>member</replaceable>,
         <replaceable>signature</replaceable>,
         <replaceable>names</replaceable>,
         <replaceable>flags</replaceable>)
         </constant>
       </para>
       <para>
-        <constant>SD_BUS_SIGNAL(
-        <replaceable>member</replaceable>,
+        <constant>SD_BUS_SIGNAL(<replaceable>member</replaceable>,
         <replaceable>signature</replaceable>,
         <replaceable>flags</replaceable>)
         </constant>
       </para>
       <para>
-        <constant>SD_BUS_WRITABLE_PROPERTY(
-        <replaceable>member</replaceable>,
+        <constant>SD_BUS_WRITABLE_PROPERTY(<replaceable>member</replaceable>,
         <replaceable>signature</replaceable>,
         <replaceable>get</replaceable>,
         <replaceable>set</replaceable>,
@@ -221,8 +211,7 @@
         </constant>
       </para>
       <para>
-        <constant>SD_BUS_PROPERTY(
-        <replaceable>member</replaceable>,
+        <constant>SD_BUS_PROPERTY(<replaceable>member</replaceable>,
         <replaceable>signature</replaceable>,
         <replaceable>get</replaceable>,
         <replaceable>offset</replaceable>,
@@ -231,9 +220,17 @@
       </para>
       <para>
         <constant>SD_BUS_PARAM(<replaceable>name</replaceable>)</constant>
+      </para>
+      <para>
         <constant>SD_BUS_ARGS(<replaceable>...</replaceable>)</constant>
+      </para>
+      <para>
         <constant>SD_BUS_RESULT(<replaceable>...</replaceable>)</constant>
+      </para>
+      <para>
         <constant>SD_BUS_NO_ARGS</constant>
+      </para>
+      <para>
         <constant>SD_BUS_NO_RESULT</constant>
       </para>
     </funcsynopsis>