summaryrefslogtreecommitdiffstatshomepage
path: root/docs
diff options
context:
space:
mode:
author Vas Crabb <vas@vastheman.com>2019-02-18 21:13:44 +1100
committer Vas Crabb <vas@vastheman.com>2019-02-18 21:13:44 +1100
commit8ffff5d2d3bcebbdbefec2508ddd2ecd264a399a (patch)
tree68d8714657d95564298b2e0736ffaea572d65afa /docs
parent4ada281e4c75650b656ee24738c4f27de5f7b498 (diff)
(nw) misc stuff:
* Document cross-compilation options * Use lowercase for some libraries that are lowercase in system32 on Windows anyway * Make USE_BUNDLED_LIB_SDL2=0 not use the bundled SDL
Diffstat (limited to 'docs')
-rw-r--r--docs/source/initialsetup/compilingmame.rst35
1 files changed, 32 insertions, 3 deletions
diff --git a/docs/source/initialsetup/compilingmame.rst b/docs/source/initialsetup/compilingmame.rst
index 1c102f66e63..44d416d3108 100644
--- a/docs/source/initialsetup/compilingmame.rst
+++ b/docs/source/initialsetup/compilingmame.rst
@@ -252,15 +252,27 @@ IGNORE_GIT
revision description in the version string.
Tool locations
-~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~
OVERRIDE_CC
- Set the C/Objective-C compiler command.
+ Set the C/Objective-C compiler command. (This sets the target C compiler
+ command when cross-compiling.)
OVERRIDE_CXX
- Set the C++/Objective-C++ compiler command.
+ Set the C++/Objective-C++ compiler command. (This sets the target C++
+ compiler command when cross-compiling.)
+OVERRIDE_LD
+ Set the linker command. This is often not necessary or useful because the C
+ or C++ compiler command is used to invoke the linker. (This sets the target
+ linker command when cross-compiling.)
PYTHON_EXECUTABLE
Set the Python interpreter command. You need Python 2.7 or Python 3 to build
MAME.
+CROSS_BUILD
+ Set to **1** to use separate host and target compilers and linkers, as
+ required for cross-compilation. In this case, **OVERRIDE_CC**,
+ **OVERRIDE_CXX** and **OVERRIDE_LD** set the target C compiler, C++ compiler
+ and linker commands, while **CC**, **CXX** and **LD** set the host C
+ compiler, C++ compiler and linker commands.
Optional features
~~~~~~~~~~~~~~~~~
@@ -439,6 +451,23 @@ variables.
Unusual Build Configurations
----------------------------
+Cross-compiling MAME
+~~~~~~~~~~~~~~~~~~~~
+
+MAME's build system has basic support for cross-compilation. Set
+**CROSS_BUILD=1** to enable separate host and target compilers, set
+**OVERRIDE_CC** and **OVERRIDE_CXX** to the target C/C++ compiler commands, and
+if necessary set **CC** and **CXX** to the host C/C++ compiler commands. If the
+target OS is different to the host OS, set it with **TARGETOS**. For example it
+may be possible to build a MinGW32 x64 build on a Linux host using a command
+like this:
+
+**make TARGETOS=windows PTR64=1 OVERRIDE_CC=x86_64-w64-mingw32-gcc OVERRIDE_CXX=x86_64-w64-mingw32-g++ OVERRIDE_LD=x86_64-w64-mingw32-ld MINGW64=/usr**
+
+(The additional packages required for producing a standard MinGW32 x64 build on
+a Fedora Linux host are `mingw64-gcc-c++`, `mingw64-winpthreads-static` and
+their dependencies. Non-standard builds may require additional packages.)
+
Using libc++ on Linux
~~~~~~~~~~~~~~~~~~~~~