@@ -15,26 +15,79 @@ learn about the making of this product.
Detailed building instruction for advanced users are available at the
<a href="http://logiqub.com/build" class="readme">build</a> page.
# Install
You can browse the source and download files on the online mercurial
<a href="http://logiqub.com/repo/" class="readme">repository</a>.
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
Find demos and tutorials showcasing the capabilities of the logiqub at the
<a href="http://logiqub.com/play" class="readme">play</a> page.
# Documentation
To learn about the underlying system, its philosophy based of the Forth
language and other materials that may help you build your own system, you
can check the <a href="http://logiqub.com/learn" class="readme">learn</a> page.
Status change: