From 8dc0bb8cdb3defbcfc24cb5036436267e5196867 Mon Sep 17 00:00:00 2001
From: emkael <emkael@tlen.pl>
Date: Wed, 1 Mar 2017 15:09:02 +0100
Subject: Build process documentation

---
 BUILD.md  | 36 ++++++++++++++++++++++++++++++++++++
 README.md |  4 ++++
 2 files changed, 40 insertions(+)
 create mode 100644 BUILD.md

diff --git a/BUILD.md b/BUILD.md
new file mode 100644
index 0000000..9e4effb
--- /dev/null
+++ b/BUILD.md
@@ -0,0 +1,36 @@
+Build instructions
+==================
+
+Prerequisites
+-------------
+
+Building `quick_lineup` relies on `pyinstaller`.
+
+You can install `pyinstaller` via PIP:
+
+```
+pip install pyinstaller
+```
+
+Build
+-----
+
+To build the binary, simply use the provided [`.spec` file](quick_lineup.spec):
+
+```
+pyinstaller quick_lineup.spec
+```
+
+The binary is compiled in the `dist` directory, while `build` directory contains intermediate files for `pyinstaller`.
+
+Known issues
+------------
+
+ * it's difficult to pin-point a specific version of `pyinstaller` which is free from all issues, as `pyinstaller` develops dynamically
+ * [pyinstaller < 3, requires manual patch] building from non-ASCII paths may be problematic or result in binaries which refuse to run
+ * [pyinstaller >= 3.2] in some specific configuration, the resulting binary may not run from a non-ASCII path (see: https://github.com/pyinstaller/pyinstaller/issues/1396)
+ * [pyinstaller >= 3.1, < 3.2] fails to overwrite its own files in `build`, the directory needs to be clean before building
+ * appending EXE version info is broken due to an upstream bug, in Python3 WinAPI bindings: (see: https://github.com/pyinstaller/pyinstaller/issues/1955)
+ * which is affected, anyway, by some antivirus software (if you're getting "Permission denied [Errno 5]" on metadata write, that may be it)
+
+Best bet is to use 3.1 and clear `build` manually between builds. 3.2 (3.2.1 in my case) works fine, but some users reported inability to run the compiled EXE (hi, Olo).
diff --git a/README.md b/README.md
index dba7b4e..6152300 100644
--- a/README.md
+++ b/README.md
@@ -34,3 +34,7 @@ python quick_lineup.py 3 2 1
 ```
 
 The script will iterate pair by pair in each match. It presents the currently assigned players and let you confirm them - pressing ENTER without any input - or change - providing player names (press TAB to autocomplete).
+
+# Build process
+
+See: [BUILD.md](BUILD.md)
-- 
cgit v1.2.3