# HG changeset patch
# User logiqub <logiqub@gmail.com>
# Date 2019-08-25 14:44:05
# Node ID 3c296b6777248233637305aff6a2335ae431c27f
# Parent  b4749e92a65fcef7404019963a048ab9b4d321cc

README install windows

diff --git a/README.md b/README.md
--- a/README.md
+++ b/README.md
@@ -24,8 +24,61 @@ Supported systems and architectures:
 
 * Windows - x86
 * Linux - x86
-* Raspbian - ARMv7
-* Java - JVM (experimental)
+* Raspbian - ARMv7 (beta)
+* Java - JVM (alpha)
+
+## Windows
+
+### 1) Binary
+
+You can download a prebuilt binary here: <a href="http://logiqub.com/download/windows/logiqub.zip">logiqub.zip</a>.
+
+### 2) Source
+
+You can also compile the logiqub executable from source.
+
+Install Mininal GNU for Windows: <a href="www.mingw.org">MinGW</a>.
+Open a terminal.
+
+    pacman -S binutils
+    pacman -S gdb                 # optional, to debug the virtual machine
+    pacman -S ansicon
+    pacman -S msys/winpty
+    pacman -S msys/make
+    pacman -S mercurial
+
+    cd $HOME                      # if you wish to install there
+    hg clone http://logiqub@logiqub.com/repo/logiqub
+
+    cd logiqub/system/windows
+    make                          # release build
+    make debug                    # debug build (symbols for gdb)
+
+To properly install the executable, you should add it to your PATH environment
+variable. You can also create a logiqub.rc file with aliases and some paths.
+
+    alias run="ansixon_x86 winpty logiqub"
+    alias debug="ansixon_x86 winpty gdb --args logiqub"
+    export PATH=$PATH:$HOME/logiqub/system/windows
+    export LD_LIBRARY_PATH="/mingw32/i686-w64-mingw32/lib"
+
+Make sure to "source logiqub.rc" in your .bashrc file to make the aliases
+available, or do it manually.
+
+If you wish to use SDL2 applications, get the library and at least the image addon:
+
+    pacman -S mingw32/mingw-w64-i686-SDL2 
+    pacman -S mingw32/mingw-w64-i686-SDL2_image
+    pacman -S mingw32/mingw-w64-i686-SDL2_mixer
+    pacman -S mingw32/mingw-w64-i686-SDL2_ttf
+
+Verify installation
+
+    cd $HOME/logiqub/demo
+    run ascii.qub
+
+    cd tetris
+    run main.qub
 
 # Execution