From d1664226d36062216280387f330e7a897046db97 Mon Sep 17 00:00:00 2001
From: Don Ho <don.h@free.fr>
Date: Fri, 29 Dec 2023 04:22:00 +0100
Subject: [PATCH] Add comments in RTL localization files for explanation of
 "editZoneRTL"

---
 PowerEditor/installer/nativeLang/arabic.xml  | 7 +++++++
 PowerEditor/installer/nativeLang/farsi.xml   | 7 +++++++
 PowerEditor/installer/nativeLang/hebrew.xml  | 7 +++++++
 PowerEditor/installer/nativeLang/kurdish.xml | 7 +++++++
 PowerEditor/installer/nativeLang/urdu.xml    | 7 +++++++
 PowerEditor/installer/nativeLang/uyghur.xml  | 7 +++++++
 6 files changed, 42 insertions(+)

diff --git a/PowerEditor/installer/nativeLang/arabic.xml b/PowerEditor/installer/nativeLang/arabic.xml
index 9fc101d3d..0f1ea6a47 100644
--- a/PowerEditor/installer/nativeLang/arabic.xml
+++ b/PowerEditor/installer/nativeLang/arabic.xml
@@ -8,6 +8,13 @@
     - &quot; is (")
     -->
 <NotepadPlus>
+	<!--
+	If "RTL" attribute is present and its value is "yes", then user can add "editZoneRTL" attribute beside,
+	and set the value of the attribute in question to "no", so Notepad++ GUI will be RTL,
+	but Scintilla zone will be LTR by opening files (see the commented example).
+	Of course, user can set any direction they want afterward, and what they have set on document will be remembered across the sessions.
+	-->
+	<!-- Native-Langue name="Arabic" filename="arabic.xml" RTL="yes" editZoneRTL="no" version="7.7.2" -->
 	<Native-Langue name="Arabic" filename="arabic.xml" RTL="yes" version="7.7.2">
 		<Menu>
 			<Main>
diff --git a/PowerEditor/installer/nativeLang/farsi.xml b/PowerEditor/installer/nativeLang/farsi.xml
index 46c380f45..c101ef40b 100644
--- a/PowerEditor/installer/nativeLang/farsi.xml
+++ b/PowerEditor/installer/nativeLang/farsi.xml
@@ -1,5 +1,12 @@
 <?xml version="1.0" encoding="utf-8" ?>
 <NotepadPlus>
+	<!--
+	If "RTL" attribute is present and its value is "yes", then user can add "editZoneRTL" attribute beside,
+	and set the value of the attribute in question to "no", so Notepad++ GUI will be RTL,
+	but Scintilla zone will be LTR by opening files (see the commented example).
+	Of course, user can set any direction they want afterward, and what they have set on document will be remembered across the sessions.
+	-->
+	<!-- Native-Langue name="Farsi" RTL="yes" editZoneRTL="no" filename="farsi.xml" version="7.0" -->
 	<Native-Langue name="Farsi" RTL="yes" filename="farsi.xml" version="7.0">
 		<Menu>
 			<Main>
diff --git a/PowerEditor/installer/nativeLang/hebrew.xml b/PowerEditor/installer/nativeLang/hebrew.xml
index 19d7900c1..e62d85653 100644
--- a/PowerEditor/installer/nativeLang/hebrew.xml
+++ b/PowerEditor/installer/nativeLang/hebrew.xml
@@ -1,5 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
 <NotepadPlus>
+	<!--
+	If "RTL" attribute is present and its value is "yes", then user can add "editZoneRTL" attribute beside,
+	and set the value of the attribute in question to "no", so Notepad++ GUI will be RTL,
+	but Scintilla zone will be LTR by opening files (see the commented example).
+	Of course, user can set any direction they want afterward, and what they have set on document will be remembered across the sessions.
+	-->
+	<!-- Native-Langue name="Hebrew" RTL="yes" editZoneRTL="no" filename="hebrew.xml" -->
 	<Native-Langue name="Hebrew" RTL="yes" filename="hebrew.xml">
 		<Menu>
 			<Main>
diff --git a/PowerEditor/installer/nativeLang/kurdish.xml b/PowerEditor/installer/nativeLang/kurdish.xml
index a8cfcaa38..774123cf5 100644
--- a/PowerEditor/installer/nativeLang/kurdish.xml
+++ b/PowerEditor/installer/nativeLang/kurdish.xml
@@ -1,5 +1,12 @@
 <?xml version="1.0" encoding="utf-8" ?>
 <NotepadPlus>
+	<!--
+	If "RTL" attribute is present and its value is "yes", then user can add "editZoneRTL" attribute beside,
+	and set the value of the attribute in question to "no", so Notepad++ GUI will be RTL,
+	but Scintilla zone will be LTR by opening files (see the commented example).
+	Of course, user can set any direction they want afterward, and what they have set on document will be remembered across the sessions.
+	-->
+	<!-- Native-Langue name="كوردی" RTL="yes" editZoneRTL="no" filename="kurdish.xml" version="7.5" -->
 	<Native-Langue name="كوردی" RTL="yes" filename="kurdish.xml" version="7.5">
 		<Menu>
 			<Main>
diff --git a/PowerEditor/installer/nativeLang/urdu.xml b/PowerEditor/installer/nativeLang/urdu.xml
index 2d639f6fb..e3fd02add 100644
--- a/PowerEditor/installer/nativeLang/urdu.xml
+++ b/PowerEditor/installer/nativeLang/urdu.xml
@@ -1,5 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
 <NotepadPlus>
+	<!--
+	If "RTL" attribute is present and its value is "yes", then user can add "editZoneRTL" attribute beside,
+	and set the value of the attribute in question to "no", so Notepad++ GUI will be RTL,
+	but Scintilla zone will be LTR by opening files (see the commented example).
+	Of course, user can set any direction they want afterward, and what they have set on document will be remembered across the sessions.
+	-->
+	<!-- Native-Langue name="Urdu" RTL="yes" editZoneRTL="no" filename="urdu.xml" -->
 	<Native-Langue name="Urdu" RTL="yes" filename="urdu.xml">
 		<Menu>
 			<Main>
diff --git a/PowerEditor/installer/nativeLang/uyghur.xml b/PowerEditor/installer/nativeLang/uyghur.xml
index 54cf46da5..c0f126e8d 100644
--- a/PowerEditor/installer/nativeLang/uyghur.xml
+++ b/PowerEditor/installer/nativeLang/uyghur.xml
@@ -4,6 +4,13 @@
 <!-- If you want to see RTL direction, please rewrite  <Native-Langue name="Uyghurche" RTL="yes" filename="uyghur.xml" > -->
 <!--ئوڭدىن سولغا كۆرمەكچى بولسىڭىز،بۇنى 2-قۇر بىلەن ئالماشتۇرۇڭ <Native-Langue name="Uyghurche" RTL="yes" filename="uyghur.xml" >-->
 <NotepadPlus>
+	<!--
+	If "RTL" attribute is present and its value is "yes", then user can add "editZoneRTL" attribute beside,
+	and set the value of the attribute in question to "no", so Notepad++ GUI will be RTL,
+	but Scintilla zone will be LTR by opening files (see the commented example).
+	Of course, user can set any direction they want afterward, and what they have set on document will be remembered across the sessions.
+	-->
+	<!-- Native-Langue name="Uyghurche" RTL="yes" editZoneRTL="no" filename="uyghur.xml" -->
 	<Native-Langue name="Uyghurche" RTL="yes" filename="uyghur.xml">
 		<Menu>
 			<Main>