Add information on compiling source code on Mac OS X
to the documentation.
Signed-off-by: John Arbuckle <[email protected]>
---
This patch may depend on the other patch I sent in for the qemu-doc.texi file.
qemu-doc.texi | 41 ++++++++++++++++++++++++++++++++++++++---
1 files changed, 38 insertions(+), 3 deletions(-)
diff --git a/qemu-doc.texi b/qemu-doc.texi
index 9a8f353..eb4ce8d 100644
--- a/qemu-doc.texi
+++ b/qemu-doc.texi
@@ -3024,9 +3024,44 @@ and all other qemu-system-@var{target}.exe compiled for
Win32.
@node Mac OS X
@section Mac OS X
-The Mac OS X patches are not fully merged in QEMU, so you should look
-at the QEMU mailing list archive to have all the necessary
-information.
+After downloading the QEMU source code, double-click it to expand it.
+
+Then configure QEMU to build the emulator you want using the --target-list
option:
+@example
+./configure --target-list=ppc-softmmu,i386-softmmu --disable-sdl --disable-gtk
+@end example
+
+@smalldisplay
+*Disabling SDL and GTK support is suggested because QEMU runs poorly with them.
+@end smalldisplay
+
+Start building QEMU using the make command:
+@example
+make
+@end example
+
+Note: Apple supplied versions of gcc may not work with QEMU. If after the
configure
+step you see a message like this:
+@example
+ERROR: Your compiler does not support the __thread specifier for
+ Thread-Local Storage (TLS). Please upgrade to a version that does.
+@end example
+You may have to build your own version of gcc from source. Expect that to take
+several hours. GCC 4.3 or above would work. More information can be found here:
+https://gcc.gnu.org/install/ @*
+
+These are some of the third party binaries of gcc available for download:
+@itemize
+@item Homebrew http://brew.sh/
+@item https://www.litebeam.net/gcc/gcc_472.pkg
+@item http://www.macports.org/ports.php?by=name&substr=gcc
+@end itemize
+
+You can have several versions of GCC on your system. To specify a certain
version,
+use the --cc and --cxx options.
+@example
+./configure --cxx=<path of your c++ compiler> --cc=<path of your c compiler>
<other options>
+@end example
@node Make targets
@section Make targets
--
1.7.5.4
