[ming2] Update instructions
Part of https://github.com/harfbuzz/harfbuzz/issues/1728
Only left to write how to create a win32 bundle.
diff --git a/README.mingw.md b/README.mingw.md
index 3421429..76d1a87 100644
--- a/README.mingw.md
+++ b/README.mingw.md
@@ -4,37 +4,45 @@
is or wasn't that clear. For having access to Uniscribe on Linux/macOS these
steps are recommended:
-1. Install Wine from your favorite package manager.
+1. Install Wine from your favorite package manager. On Fedora that's `dnf install wine`.
2. And `mingw-w64` compiler.
- With `brew` on macOS, you can have it like `brew install mingw-w64`
+ With `brew` on macOS, you can have it like `brew install mingw-w64`.
+ On Fedora, with `dnf install mingw32-gcc-c++`, or `dnf install mingw64-gcc-c++` for the
+ 64-bit Windows.
-3. Download and put [this](https://drive.google.com/open?id=0B3_fQkxDZZXXbWltRGd5bjVrUDQ)
- on your `~/.local/i686-w64-mingw32`.
-
-4. Replace all the instances of `/home/behdad/.local/i586-mingw32msvc`
- and `/home/behdad/.local/i686-w64-mingw32` with `<$HOME>/.local/i686-w64-mingw32`
- on that folder. (`<$HOME>` replace it with `/home/XXX` or `/Users/XXX` on macOS)
-
- Probably you shouldn't replace the ones are inside binaries.
+3. Install cross-compiled dependency packages. Alternatively see [^1] below.
+ On Fedora that would be `dnf install mingw32-glib2 mingw32-cairo mingw32-freetype`
+ for 32-bit, or `dnf install mingw64-glib2 mingw64-cairo mingw64-freetype` for 64-bit.
5. `NOCONFIGURE=1 ./autogen.sh && mkdir winbuild && cd winbuild`
-6. `../mingw32.sh && cd ..`
+6. Run `../mingw32.sh` for 32-bit build, or `../mingw64.sh` for 64-bit. This configures
+ HarfBuzz for cross-compiling. It enables Uniscribe backend as well.
-7. `make -Cwinbuild`
+7. `make`
-Now you can use hb-shape using `wine winbuild/util/hb-shape.exe` but if you like to
-to use the original Uniscribe,
+Now you can use hb-shape using `wine util/hb-shape.exe` but if you like to shape with
+the Microsoft Uniscribe,
8. Bring a 32bit version of `usp10.dll` for yourself from `C:\Windows\SysWOW64\usp10.dll` of your
- Windows installation (assuming you have a 64-bit installation, otherwise `C:\Windows\System32\usp10.dll`)
- that it is not a DirectWrite proxy ([for more info](https://en.wikipedia.org/wiki/Uniscribe)).
+ Windows installation (assuming you have a 64-bit installation, otherwise
+ `C:\Windows\System32\usp10.dll`) that it is not a DirectWrite proxy
+ ([for more info](https://en.wikipedia.org/wiki/Uniscribe)).
Rule of thumb, your `usp10.dll` should have a size more than 500kb, otherwise
it is designed to work with DirectWrite which Wine can't work with its original one.
+ You want a Uniscribe from Windows 7 or older.
- Put the dll on the folder you are going to run the next command,
+ Put the DLL in the folder you are going to run the next command,
-9. `WINEDLLOVERRIDES="usp10=n" wine winbuild/util/hb-shape.exe fontname.ttf -u 0061,0062,0063 --shaper=uniscribe`
+9. `WINEDLLOVERRIDES="usp10=n" wine util/hb-shape.exe fontname.ttf -u 0061,0062,0063 --shaper=uniscribe`
(`0061,0062,0063` means `abc`, use test/shaping/hb-unicode-decode to generate ones you need)
+
+
+[^1] Download and put [this](https://drive.google.com/open?id=0B3_fQkxDZZXXbWltRGd5bjVrUDQ)
+ in your `~/.local/i686-w64-mingw32`. Then replace all the instances of
+ `/home/behdad/.local/i586-mingw32msvc` and `/home/behdad/.local/i686-w64-mingw32`
+ with `<$HOME>/.local/i686-w64-mingw32` on that folder.
+ (`<$HOME>` replace it with `/home/XXX` or `/Users/XXX` on macOS)
+ You shouldn't replace the instances of those inside binary files.
