9b162ca
From 93a39bd12db11dd407676f428cfbc30406a88c36 Mon Sep 17 00:00:00 2001
9b162ca
From: Sumit Bose <sbose@redhat.com>
9b162ca
Date: Mon, 15 Jun 2020 15:57:47 +0200
9b162ca
Subject: [PATCH 2/3] man: explain optional parameter of login-ccache better
9b162ca
9b162ca
Resolves: https://bugzilla.redhat.com/show_bug.cgi?id=1791545
9b162ca
---
9b162ca
 doc/adcli.xml | 20 +++++++++++++-------
9b162ca
 1 file changed, 13 insertions(+), 7 deletions(-)
9b162ca
9b162ca
diff --git a/doc/adcli.xml b/doc/adcli.xml
9b162ca
index acced25..ecf8726 100644
9b162ca
--- a/doc/adcli.xml
9b162ca
+++ b/doc/adcli.xml
9b162ca
@@ -155,13 +155,19 @@ $ LDAPTLS_CACERT=/path/to/ad_dc_ca_cert.pem adcli join --use-ldaps -D domain.exa
9b162ca
 		<varlistentry>
9b162ca
 			<term><option>-C, --login-ccache=<parameter>ccache_name</parameter></option></term>
9b162ca
 			<listitem><para>Use the specified kerberos credential
9b162ca
-                        cache to authenticate with the domain. If no credential
9b162ca
-                        cache is specified, the default kerberos credential
9b162ca
-                        cache will be used. Credential caches of type FILE can
9b162ca
-                        be given with the path to the file. For other
9b162ca
-                        credential cache types, e.g. DIR, KEYRING or KCM, the
9b162ca
-                        type must be specified explicitly together with a
9b162ca
-                        suitable identifier.</para></listitem>
9b162ca
+			cache to authenticate with the domain. If no credential
9b162ca
+			cache is specified, the default kerberos credential
9b162ca
+			cache will be used. Credential caches of type FILE can
9b162ca
+			be given with the path to the file. For other
9b162ca
+			credential cache types, e.g. DIR, KEYRING or KCM, the
9b162ca
+			type must be specified explicitly together with a
9b162ca
+			suitable identifier.</para>
9b162ca
+			<para>Please note that since the
9b162ca
+			<parameter>ccache_name</parameter> is optional the
9b162ca
+			=(equal) sign is mandatory. If = is missing the
9b162ca
+			parameter is treated as optionless extra argument. How
9b162ca
+			this is handled depends on the specific sub-command.
9b162ca
+			</para></listitem>
9b162ca
 		</varlistentry>
9b162ca
 		<varlistentry>
9b162ca
 			<term><option>-U, --login-user=<parameter>User</parameter></option></term>
9b162ca
-- 
9b162ca
2.26.2
9b162ca