add MNH48 Jawi QWERTY

README.md

@@ -1,2 +1,55 @@
-# jawi-keyboard
-Jawi Keyboards
+# MNH48 Jawi Keyboard
+
+Jawi keyboards by MNH48.
+
+
+## MNH48 Jawi (QWERTY) - Windows
+
+The directory contains the keyboard layout source file in `klc` format,
+that is used in Microsoft Keyboard Layout Creator (MSKLC), as well as
+the resulting compiled installation files and libraries, minus the
+bootstrapper. Because the bootstrapper seemed to not be generated by
+MSKLC but rather just copied over, it is technically copyrighted by
+Microsoft and I cannot distribute it. The other files are actually
+compiled and I have the copyrights on them, so I can distribute them.
+
+You can also generate the files on your side from the source `klc`.
+Install MSKLC from Microsoft's website, load the `klc` file, then click
+`Project` and select `Build DLL and Setup Package`.
+
+**For users who just want to install keyboard layout and not do anything
+else, download the [latest release archive](https://github.com/jawi-mnh48/jawi-keyboard/releases/latest/download/mnh48-jawi-qwerty-windows.zip) and then open it, then
+double click on `MNHjawi_amd64.msi` to install and you're done.**
+
+If you cannot run `MNHjawi_amd64.msi`, for example, it gives you the
+error: `Error message: The version of this file is not compatible with
+the version of Windows you're running.`, then please run `MNHjawi_i386.msi`
+instead because it means that your Windows or your processor doesn't
+support amd64 instruction set. In rare cases such as on certain old
+computers with Windows XP, even `MNHjawi_i386.msi` might not work and
+you need `MNHjawi_ia64.msi` instead in those cases.
+
+The files are built on Windows 10 and has been tested to be functioning
+properly under Windows 10. The version of MSKLC used is 1.4.6000.2
+released on 2nd October 2020. The Unicode data bundled was Unicode 5.0
+but I've manually downloaded Unicode 13.0 data to use with MSKLC before
+compiling, so the keyboard layout I generate has support for Unicode 13.0.
+
+
+## License
+
+All of the layout themselves, as in the character position arrangement, are
+all released under The MIT license.
+
+The license for the specific files varies from one another, check the
+subsection for specific license.
+
+
+### MNH48 Jawi (QWERTY) - Windows
+
+I would actually want to release this as full featured open source, but
+there might had been some violation with Microsoft's licensing terms.
+If I read correctly, what it don't allow is the bundling of the keyboard
+layout in paid software or selling the layout itself. You can still use
+my files to install and modify as long as you abide with that terms.
+Those terms were set by Microsoft, not me.