Clarify that IGNORE_DIACRITICS_CTL is not only CTL, despite its name

Change-Id: I5954094131debb7cdf0fc44a9db3a3609b356baf

include/i18nutil/transliteration.hxx

@@ -119,7 +119,9 @@ enum class TransliterationFlags {
     /// transliterate Japanese normal sized character to small sized character
     largeToSmall_ja_JP             = int(css::i18n::TransliterationModules_largeToSmall_ja_JP),
 
+    /// Transliterate decomposing and removing diacritics, not only CTL, despite its name.
     IGNORE_DIACRITICS_CTL          = int(css::i18n::TransliterationModulesExtra::IGNORE_DIACRITICS_CTL),
+    /// Ignore Kashida mark.
     IGNORE_KASHIDA_CTL             = int(css::i18n::TransliterationModulesExtra::IGNORE_KASHIDA_CTL)
 };
 namespace o3tl {

offapi/com/sun/star/i18n/TransliterationModulesExtra.idl

@@ -50,8 +50,17 @@ constants TransliterationModulesExtra
      */
     const short TOGGLE_CASE = 202;
 
-    /// because we cannot extend TransliterationModule we used TranslationModuleExtra and it will act the same way
+    /** Ignore diacritics. Despite the _CTL name suffix this is not only
+        about CTL/Arabic diacritic characters, though these are handled
+        as well, but the transliteration decomposes and removes any
+        diacritic from characters.
+
+        Because we cannot extend the TransliterationModules enum we use
+        TranslationModuleExtra and it will act the same way.
+     */
     const long IGNORE_DIACRITICS_CTL   = 0x40000000;
+
+    /** Ignore Kashida mark. */
     const long IGNORE_KASHIDA_CTL      = 0x00000800;
 
     const long END_OF_MODULE    = 0;