doc: don't let perl do inplace modifications of conf.py
[git-cola.git] / darwin / README
blob062e59d4d6ec10043292ec346a36731b21f55419
1 To build Mac OSX installers you need to setup your build environment
2 first.  MacPorts can be used for this.
4 The macports-setup-dev-env.sh script sets up your build environment.
5 It'll take a long time to run.
7 Once you've installed the macports packages then you should be able
8 to run cola out of its source tree.  This is a good sanity check
9 before trying to build git-cola.app:
11         $ cola=$PWD
12         $ make
13         $ cd $there
14         $ $cola/bin/git-cola
16 Once that's working then you can generate git-cola.app:
18         $ make git-cola.app
19         # double-click or run 'open' on the generated .app bundle
22 NOTE: Some Mac OS X flavors won't be able to run the generated git-cola.app
23 when macports is installed on the system.  There is a problem where
24 the dynamic loader tries to load the Qt libraries twice.
26 This workaround was not needed on an Intel Leopard machine but was
27 needed when testing the package on a PPC Tiger machine.  YMMV.
29 A workaround that allows you to test the .app is to fake the
30 removal of macports:
32         cd /opt
33         sudo mv local local.bak
34         open /path/to/git-cola.app # this should work now
35         sudo mv local.bak local
37 Don't try this unless you have problems running git-cola.app on a
38 mac build machine.  Some Mac OS X variants do not have this problem
39 and it's likely that the problem only exists on PPC Tiger machines.