From 228b21c253a6598c8a95f0cb56e9c6acf8bb8caa Mon Sep 17 00:00:00 2001
From: Sumit Bose <sbose@redhat.com>
Date: Thu, 12 Dec 2019 13:10:16 +0100
Subject: [PATCH] certmap: mention special regex characters in man page

Since some of the matching rules use regular expressions some characters
must be escaped so that they can be used a ordinary characters in the
rules.

Related to https://pagure.io/SSSD/sssd/issue/4127
---
 src/man/sss-certmap.5.xml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/src/man/sss-certmap.5.xml b/src/man/sss-certmap.5.xml
index db258d14ab..10343625ef 100644
--- a/src/man/sss-certmap.5.xml
+++ b/src/man/sss-certmap.5.xml
@@ -92,6 +92,15 @@
                     <para>
                         Example: &lt;SUBJECT&gt;.*,DC=MY,DC=DOMAIN
                     </para>
+                    <para>
+                        Please note that the characters "^.[$()|*+?{\" have a
+                        special meaning in regular expressions and must be
+                        escaped with the help of the '\' character so that they
+                        are matched as ordinary characters.
+                    </para>
+                    <para>
+                        Example: &lt;SUBJECT&gt;^CN=.* \(Admin\),DC=MY,DC=DOMAIN$
+                    </para>
                     </listitem>
                 </varlistentry>
                 <varlistentry>