From dc1f6516995a3af420a6bf4500c92f82cef74803 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=BD=D0=B0=D0=B1?= <nabijaczleweli@nabijaczleweli.xyz>
Date: Sat, 6 Sep 2025 12:49:57 +0200
Subject: [PATCH] dbus-send.1.xml: improve SYNOPSIS --print-reply rendering

Previously, it rendered as
  .No --print-reply Op Ar =literal
  \fR--print-reply [\fI=literal\fR]
which (even when we accept using No for Cm) is wrong semantically,
since it means "option --print-reply with optional option-argument
bound to variable '=literal'"

Since the usage is actually
"option --print-reply or option --print-reply=literal",
the correct rendering is
  .Fl -print-reply Ns Op = Ns Cm literal
which, when we accept using No for Cm, is
  .No --print-reply Ns Op =literal
  \fR--print-reply[=literal]
but due to docbook limitations(?) we can only get
  .No --print-reply Op =literal
  \fR--print-reply [=literal]
which is still an improvement
---
 doc/dbus-send.1.xml.in | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/dbus-send.1.xml.in b/doc/dbus-send.1.xml.in
index 9acb6c7a..5450a6e3 100644
--- a/doc/dbus-send.1.xml.in
+++ b/doc/dbus-send.1.xml.in
@@ -24,7 +24,7 @@
   <group choice='opt'><arg choice='plain'>--system </arg><arg choice='plain'>--session </arg><arg choice='plain'>--bus=<replaceable>ADDRESS</replaceable></arg><arg choice='plain'>--peer=<replaceable>ADDRESS</replaceable></arg></group>
     <arg choice='opt'>--sender=<replaceable>NAME</replaceable></arg>
     <arg choice='opt'>--dest=<replaceable>NAME</replaceable></arg>
-    <arg choice='opt'><arg choice='plain'>--print-reply </arg><arg choice='opt'><replaceable>=literal</replaceable></arg></arg>
+    <arg choice='opt'><arg choice='plain'>--print-reply</arg><arg choice='opt'>=literal</arg></arg>
     <arg choice='opt'>--reply-timeout=<replaceable>MSEC</replaceable></arg>
     <arg choice='opt'>--type=<replaceable>TYPE</replaceable></arg>
     <arg choice='plain'><replaceable>OBJECT_PATH</replaceable></arg>