Changes between Version 1 and Version 2 of Building/Preparation/MacOSX

Dec 19, 2012 11:53:15 PM (5 years ago)



  • Building/Preparation/MacOSX

    v1 v2  
    31= Setting up a MacOS X system for building GHC =
    5 See [wiki:Building/MacOSX].  !ToDo: move the relevant parts of the docs here.
     3You will need to install [ Homebrew] for getting some of the tools needed. Homebrew is recommended over other systems on OS X such as MacPorts and Fink.
     5== Xcode (GCC) ==
     7=== For Lion (10.7), Xcode 7.3 or higher ===
     9Firstly, you need to install the Xcode Command Line tools from Apple. You can do that in two ways (the second is faster):
     11 1. Install all of Xcode:
     12   * Install Xcode from the Mac App Store.
     13   * Launch Xcode.
     14   * In the Preference dialog of Xcode, select the "Downloads" pane and install "Command line tools".
     15 2. Install the command line tools only:
     16   * At the [ downloads page of Apple Developer], download the latest "Command line tools".
     17   * Install them.
     19In both cases, you need to [ register] as an Apple developer first (free).
     21=== Previous versions of OS X and Xcode ===
     23Get the most recent version of Apple's Xcode tools that you can. Your OS X CD has a version on it. You may be able to download a newer version from the [ Apple Developer Connection] website. You may need to sign up for a free membership in the Apple Developer Connection, and downloading may still cost a little money.  In later versions of OS X (10.6 / 10.7), Apple added the "App Store". Xcode is available within the App Store for "Free".
     25Successful builds of older GHC sources have been reported using Xcode 3.0, 2.4 and 2.4.1 on Intel Macs. Xcode 2.2.1 is known ''not'' to work out of the box on Intel Macs, and Xcode 3.0 is known ''not'' to work out of the box on PowerPC Macs (#2887). Versions prior to 3.1 may build GHC successfully, but choke on certain libraries.
     27== GHC ==
     29Secondly, you need a installation of GHC for use as your bootstrap compiler.
     31You can install a binary distribution of GHC in three ways:
     33  1. Install the [ Haskell Platform].
     34  2. Install via Homebrew: `brew install ghc` OR `brew install haskell-platform`.
     35  3. Install a [ binary distribution from GHC].
     37'''NB:''' You need to use a binary distribution of GHC 7.4.1 (or later) as your bootstrap compiler.
     39== GNU tools ==
     41Thirdly, if you want to build the development version of GHC from the Git repositories, you also need to install the GNU auto tools. You can get them as follows:
     43 * (Homebrew): `brew install autoconf automake`
     45== LLVM ==
     47Fourthly, if you like to use GHC's LLVM backend:
     49 * (Homebrew): `brew install llvm`
     51== Installing !DocBook ==
     53Finally, if you want to build the documentation you need to install !DocBook. You can install it like so:
     55 * (Homebrew): `brew install docbook`