From 3c080282e928a7edfcdb74feb2139ef1ac6f2ad0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= <zbyszek@in.waw.pl>
Date: Fri, 4 Mar 2022 15:23:17 +0100
Subject: [PATCH] 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.
---
 man/sd_bus_add_object.xml | 41 ++++++++++++++++++---------------------
 1 file changed, 19 insertions(+), 22 deletions(-)

diff --git a/man/sd_bus_add_object.xml b/man/sd_bus_add_object.xml
index 54683e4f11..dcf9377ffd 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>