1==== BASIC INSTALLATION ====
2
30. INSTALL REQUIRED SOFTWARE
4
5You'll need the Xcode tools installed before you can do anything.
6
7From there, there's two different ways to get the requirements: (1) homebrew
8or (2) a combination of macpkg + compiling software yourself. Using homebrew
9is highly recommended.
10
11OPTION 1: HOMEBREW
12
13Install Homebrew from: http://brew.sh/
14
15Tell Homebrew to install all the requirements:
16
17  brew install pkgconfig autoconf automake libtool libzip
18
19OPTION 2: MANUAL PACKAGE INSTALLATION
20
21First, install pkgconfig. The Mac package here is pre-built and tested:
22
23http://macpkg.sourceforge.net/
24
25You will then need to set the following in your environment for everything
26else to go smoothly:
27  export PATH=$PATH:/opt/pkgconfig/bin
28  export PKG_CONFIG=/opt/pkgconfig/bin/pkg-config
29  export PKG_CONFIG_PATH=/usr/lib/pkgconfig:/usr/local/lib/pkgconfig:/usr/X11/lib/pkgconfig
30
31Finally, you will need to install libzip, which again is straight forward:
32   ./configure --prefix=/usr
33   make
34   sudo make install
35
361. INSTALL HIDAPI (an additional pre-req)
37
38This has to be installed manually, so even if you are using homebrew, you
39still have to do this one from scratch (since you need fixes from 'git' that
40are not yet in a release). There's a few similarly named projects, you want:
41   https://github.com/signal11/hidapi
42
43Grab the source from git (NOT a release), and do:
44   ./bootstrap
45   ./configure --prefix=/usr
46   make
47   sudo make install
48
492. BUILD LIBCONCORD
50
51   As a normal user...
52     A. ****IF**** You are building from git run "autoreconf --install"
53        Note that if you compiled the depenencies by hand, you proably
54        need to do this instead:
55          aclocal -I /opt/pkgconfig/share/aclocal
56          autoheader
57          automake
58          autoconf
59     B. Run "./configure"
60     C. Run "make"
61
62Various options, such as '--prefix' are available to the configure script to
63help you choose where software gets installed and how it is built.
64
653. INSTALL THE SOFTWARE
66
67As root, simply run "make install"
68
69
70==== UNINSTALLATION ====
71
72Due to a bug in libtool on OSX, 'make uninstall' won't actually remove
73everything from your system. You will need to do:
74    sudo rm -f /usr/lib/libconcord*
75
76Assuming you installed with a prefix of /usr
77
78vim:textwidth=78:
79