doc/texi/Building.osx.texi

   1 @input texinfo @c -*- Texinfo -*-
   2 @c %**start of header
   3 @setfilename Building.osx.info
   4 @include base/article.texi
   5 @include building/command.texi
   6 @paragraphindent none
   7
   8 @set BG.platform osx
   9 @c %**end of header
  10
  11 @majorheading Guide to Building @value{HB.title} on @value{OS.@value{BG.platform}}
  12
  13 @quotation Warning
  14 Parallel builds on @value{OS.osx} are currently broken when building in a @b{terminal} with Xcode. You @b{must not use} the @command{make -jN} jobs option. A workaround is available if you do not need to build HandBrake.app (MacGUI): use @command{configure --disable-xcode} to disable Xcode.
  15 @end quotation
  16
  17 @contents
  18 @include building/chapter.introduction.texi
  19
  20 @c %**-------------------------------------------------------------------------
  21 @anchor{prerequisites}
  22 @chapter Prerequisites
  23 Building on @value{OS.osx} is well supported. It is the reference platform for @value{HB.name}. The following are the recommended specifications for this platform; but is not necessarily the only configuration that is possible:
  24
  25 @itemize @bullet
  26 @item Mac Intel hardware
  27 @item @value{OS.osx} 10.5.6
  28 @item Xcode-3.1.2
  29 @item gcc 4.0.1 (Apple Inc. build 5490)
  30 @item yasm 0.7.2.2153 (for i386 and x86_64 architectures)
  31 @end itemize
  32
  33 @include building/prerequisites.bundled.texi
  34 @include building/prerequisites.common.texi
  35
  36 @c %**-------------------------------------------------------------------------
  37 @include building/chapter.quickstart.texi
  38
  39 @c %**-------------------------------------------------------------------------
  40 @anchor{overview}
  41 @chapter Overview
  42 The two general methods to build on @value{OS.osx} are building from @b{terminal} or @b{Xcode}. The preferred method for automated and repeatable builds is to use the terminal. Otherwise the choice is generally up to the individual. In essence, the terminal actually invokes @command{xcodebuild} to build the very same targets contained in the Xcode project.
  43
  44 @include building/chapter.via.terminal.texi
  45 @include building/chapter.via.xcode.texi