Changeset 4f3fe48 in buchla-emu for readme.txt

Timestamp:

07/23/2017 04:41:10 PM (7 years ago)

Author:

Thomas Lopatic <thomas@…>

Branches:

master

Children:

8e1b163

Parents:

2a75e87

Message:

Support cross-build for Windows.

File:

• readme.txt (modified) (2 diffs)

readme.txt

@@ -32 +32 @@
   https://www.freetype.org/
 
-Currently, the emulator supports Linux and OS X. A port to Windows
-should be pretty easy, given that it doesn't use any platform-specific
-features, just C99 and SDL2.
+Currently, we build the emulator code natively on Linux and OS X. The
+Windows version is cross-compiled on Linux using a x86_64-w64-mingw32
+toolchain.
 
-Our Makefile expects all of the above libraries to reside in
-/opt/sdl2. This is how we typically install them:
+For Linux and OS X, our Makefile expects all of the above libraries to
+reside in /opt/sdl2. This is how we typically install them:
 
   # Build and install FreeType first
@@ -85 +85 @@
 
 from the top-level directory of this repository to build the emulator.
+
+The cross-build for Windows is done similarly, with the following
+differences when configuring the libraries:
+
+  * We use "--prefix=/opt/sdl2-win" instead of "--prefix=/opt/sdl2",
+    so that the Windows versions of the libraries go to a different
+    directory.
+
+  * We additionally specify "--host=x86_64-w64-mingw32" to enable
+    cross-compilation.
+
+Then, to cross-build the emulator, invoke
+
+  make buchla WIN=1
+
+from the top-level directory of this repository.