From 3cfa80c8fdb34c050cbe63e273d5cf53dc5d7863 Mon Sep 17 00:00:00 2001
From: David D Lowe <daviddlowe.flimm@gmail.com>
Date: Thu, 12 Jan 2017 09:59:50 +0100
Subject: [PATCH] Add explanation section in README.md

---
 README.md                    |  38 +++++++++++++++++++++++++++++++++++
 docs/normal_peace.png        | Bin 0 -> 3326 bytes
 docs/sublime_peace.png       | Bin 0 -> 3930 bytes
 docs/sublime_peace_after.png | Bin 0 -> 3850 bytes
 4 files changed, 38 insertions(+)
 create mode 100644 docs/normal_peace.png
 create mode 100644 docs/sublime_peace.png
 create mode 100644 docs/sublime_peace_after.png

diff --git a/README.md b/README.md
index b807160..c88862e 100644
--- a/README.md
+++ b/README.md
@@ -34,6 +34,44 @@ Tools > Bidirectional text
 Ctrl + B
 Right click > Bidirectional text
 
+How does this work?
+-------------------
+
+This tool takes a similar approach as to tools like [python-bidi](https://github.com/MeirKriheli/python-bidi), [python-arabic-reshaper](https://github.com/mpcabd/python-arabic-reshaper), [Better-Arabic-Reshaper](https://github.com/agawish/Better-Arabic-Reshaper/) and others.
+It does not make Sublime Text fully support bidirectional text.
+Rather, it uses a clever hack to make the text in the Arabic family of languages look acceptable.
+
+Take the word سلام, for instance, made of the these Unicode code-points in the order that they are typed and stored on disk:
+
+- `U+0633 ARABIC LETTER SEEN`
+- `U+0644 ARABIC LETTER LAM`
+- `U+0627 ARABIC LETTER ALEF`
+- `U+0645 ARABIC LETTER MEEM`
+
+These letters should be displayed right-to-left visually, and the letters should change shape depending on their position as expected in Arabic, like in this image:
+
+![](docs/normal_peace.png)
+
+Instead, Sublime Text 3 displays the letters left-to-right visually (which is the wrong order), and the letters are incorrectly disconnected:
+
+![](docs/sublime_peace.png)
+
+When you run this plugin with the selected text, it transforms the text into these Unicode code points in this order:
+
+- `U+FEE1 ARABIC LETTER MEEM ISOLATED FORM`
+- `U+FEFC ARABIC LIGATURE LAM WITH ALEF FINAL FORM`
+- `U+FEB3 ARABIC LETTER SEEN INITIAL FORM`
+
+These Unicode code-points are different from the original ones, because they specify exactly in which inflexible form each letter should be displayed (and the two letters *lam* and *alef* have been converted into one code point).
+The order as well as changed, now the letter that is the right-most is first, rather then the letter that is read the first.
+
+The effect is that the Arabic text now looks pretty in editors with poor bidi support like Sublime Text, like in this image:
+
+![](docs/sublime_peace_after.png)
+
+However, you will still have issues if you try to edit the text.
+
+
 Bug tracker
 ----------
 Post an issue here on Github. 
diff --git a/docs/normal_peace.png b/docs/normal_peace.png
new file mode 100644
index 0000000000000000000000000000000000000000..0d8e9bab8b1146b04eabaab4c4ec2efe0549e79f
GIT binary patch
literal 3326
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
G1NuMoA5r-L

literal 0
HcmV?d00001

diff --git a/docs/sublime_peace.png b/docs/sublime_peace.png
new file mode 100644
index 0000000000000000000000000000000000000000..ff4816e73648346cc994652f386844505cdc255b
GIT binary patch
literal 3930
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

literal 0
HcmV?d00001

diff --git a/docs/sublime_peace_after.png b/docs/sublime_peace_after.png
new file mode 100644
index 0000000000000000000000000000000000000000..240df8f711de8e25b8368d35ee7dd51e858b78c6
GIT binary patch
literal 3850
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
M07*qoM6N<$g1nv?`~Uy|

literal 0
HcmV?d00001