On Aug 14, 2015, at 11:16 AM, Peter Maydell wrote:
> On 7 August 2015 at 21:57, Programmingkid <programmingk...@gmail.com> wrote:
>> Add information on compiling source code on Mac OS X
>> to the documentation.
>>
>> Signed-off-by: John Arbuckle <programmingk...@gmail.com>
>
>> ---
>> qemu-doc.texi | 44 +++++++++++++++++++++++++++++++++++++++++---
>> 1 files changed, 41 insertions(+), 3 deletions(-)
>>
>> diff --git a/qemu-doc.texi b/qemu-doc.texi
>> index 0125bc7..c059c49 100644
>> --- a/qemu-doc.texi
>> +++ b/qemu-doc.texi
>> @@ -3021,9 +3021,47 @@ 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.
>> +System Requirements:
>> +@itemize
>> +@item Mac OS 10.5 or higher
>> +@item GCC 4.3 or higher
>
> I think this should be "The clang compiler shipped with Xcode 4.2 or higher,
> or GCC 4.3 or higher".
Sounds good.
>
> We should have an @item about any library dependencies we need that
> aren't provided by Apple. I think that's just glib, but it's been
> so long since I installed dependencies for QEMU I forget if we
> need anything else third-party. (We don't need to go into detail
> about where to get the third-party libs, but mentioning the
> dependency is helpful I think.)
That is a really good idea. This is probably what a mac user will have to
install
when installing QEMU for the first time:
- libffi
- gettext
- glib
- pgk-config
- autoconfig
- automake
- libtool
- pixman
This is all I had to install when installing QEMU onto Mac OS 10.9 for the
first time.
I could put this information in its own section like this:
Additional requirements (install in order)
1. libffi
2. gettext
3. glib
4. pgk-config
5. autoconfig
6. automake
7. libtool
8. pixman
Each item will be a hyperlink to each item's web site. Does this sound right?
>
>> +@end itemize
>> +
>> +After downloading the QEMU source code, double-click it to expand it.
>> +
>> +Then configure and make QEMU:
>> +@example
>> +./configure
>> +make
>> +@end example
>> +
>> +If you have a recent version of Mac OS X (OSX 10.7 or better
>> +with Xcode 4.2 or better) we recommend building QEMU with the
>> +default compiler provided by Apple, for your version of Mac OS X
>> +(which will be 'clang'). The configure script will
>> +automatically pick this.
>> +
>> +Note: 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
>
> this should be lower case "you"
>
>> +several hours. More information can be found here:
>> +@uref{https://gcc.gnu.org/install/} @*
>> +
>> +These are some of the third party binaries of gcc available for download:
>> +@itemize
>> +@item Homebrew: @uref{http://brew.sh/}
>> +@item @uref{https://www.litebeam.net/gcc/gcc_472.pkg}
>> +@item @uref{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
>
> Otherwise this looks good.
>
> thanks
> -- PMM
