From d54501b32cff5466c4f71d361d910141ee6e2371 Mon Sep 17 00:00:00 2001
From: Laurent Indermuehle <laurent.indermuehle@pm.me>
Date: Tue, 3 Oct 2023 08:59:42 +0200
Subject: [PATCH] document module option column_case_sensitive

---
 plugins/modules/mysql_role.py | 10 ++++++++++
 plugins/modules/mysql_user.py | 10 ++++++++++
 2 files changed, 20 insertions(+)

diff --git a/plugins/modules/mysql_role.py b/plugins/modules/mysql_role.py
index 7d672d7..0b4324f 100644
--- a/plugins/modules/mysql_role.py
+++ b/plugins/modules/mysql_role.py
@@ -121,6 +121,16 @@ options:
     type: bool
     default: true
 
+  column_case_sensitive:
+    description:
+      - When C(true), the module won't uppercase the field in the privileges.
+      - When C(false), the field names will be upper cased. This was the default before this
+        feature was introduced but since MySQL/MariaDB is case sensitive you should set this
+        to true in most cases.
+    type: bool
+    default: false
+    version_added: '3.8.0'
+
 notes:
   - Pay attention that the module runs C(SET DEFAULT ROLE ALL TO)
     all the I(members) passed by default when the state has changed.
diff --git a/plugins/modules/mysql_user.py b/plugins/modules/mysql_user.py
index 38e5124..5e37735 100644
--- a/plugins/modules/mysql_user.py
+++ b/plugins/modules/mysql_user.py
@@ -155,6 +155,16 @@ options:
       - Cannot be used to set global variables, use the M(community.mysql.mysql_variables) module instead.
     type: dict
     version_added: '3.6.0'
+  
+  column_case_sensitive:
+    description:
+      - When C(true), the module won't uppercase the field names in the privileges.
+      - When C(false), the field names will be upper cased. This is the default
+      - This feature was introduced because MySQL 8 and above uses case sensitive
+        fields names in privileges.
+    type: bool
+    default: false
+    version_added: '3.8.0'
 
 notes:
    - "MySQL server installs with default I(login_user) of C(root) and no password.