1 files changed, 109 insertions, 0 deletions
diff --git a/docs/development/macos_development.rst b/docs/development/macos_development.rst
new file mode 100644
index 000000000..b1559c0a5
--- /dev/null
+++ b/docs/development/macos_development.rst
@@ -0,0 +1,109 @@
+=================
+MacOS Development
+=================
+
+Here are some notes about running navit under Apple Mac OSX.
+
+What you will need
+==================
+
+You need Xcode Tools and MacPorts in order to install navit.
+
+MacPorts developers suggest to install Xcode Tools from http://developer.apple.com/tools/xcode/ and not from the Mac OSX install disk.
+See `Mac-How <http://www.mac-how.net/>`_
+
+Make sure you don't have fink installed on your system, it can confuse MacPorts package building and installation.
+
+ * GTK Gui: You should only need gtk2 and glib2 via macPorts
+ * SDL Gui: Untested yet.
+
+Installation instruction
+========================
+
+Download Xcode Tools from http://developer.apple.com/tools/xcode/ and install it with X11 SDK
+
+Download and Install MacPorts from http://www.macports.org/, or update your version
+
+.. code-block:: bash
+
+    sudo port -d selfupdate
+
+Open up a terminal
+
+make sure your PATH variables has `/opt/local/bin` and `/opt/local/sbin` in it:
+
+.. code-block:: bash
+
+    echo $PATH
+
+
+Install automake, wget, libtool, gpsd (if you want gps support), gtk2 and glib2 (for gkt GUI) with
+
+.. code-block:: bash
+
+    sudo port install automake wget gpsd gtk2 glib2 libtool
+
+Download navit or checkout it from Git
+
+.. code-block:: bash
+
+    git clone git@github.com:navit-gps/navit.git
+
+You may also need a header file to handle endian issues (for PPC only)
+
+.. code-block:: bash
+
+    wget https://navit.svn.sourceforge.net/svnroot/navit/tags/R0_1_0/navit/projs/CodeBlocks/Win32Extra/byteswap.h
+
+If you want to install navit along the MacPorts packages, you need to use the /opt/local directory as prefix:
+
+.. code-block:: bash
+
+  ./autogen.sh && ./configure --prefix=/opt/local --disable-binding-python
+
+type `make` to build NavIt, and `sudo make install` to install it.
+
+Then, you may edit and adapt your `navit.xml` file. The XML maptype is not supported, however normal Navit binfile works perfectly.
+
+Speech
+======
+
+If you want (spoken) directions, get espeak from http://espeak.sourceforge.net, install as advised and use the following snippet in your navit.xml:
+
+.. code-block:: xml
+
+           <speech type="cmdline" data="speak -vde+f4 '%s'"/>
+
+This will tell speak to use a female (f) german (de) voice.
+
+
+Using xcode
+===========
+
+Download one of the `Git sources <https://github.com/navit-gps/navit>`_ that don't contain autogen.sh.
+
+Open X-Code and create a new project. Cocoa will suffice
+
+Add in a new target by clicking the triangle next to "Targets" and selected the location of the navit folder. Delete the previous target.
+
+Delete the default files, and add in the navit files.
+
+In a terminal, go into the navit folder.
+
+.. code-block:: bash
+
+ ./configure --disable-binding-python --disable-sample-map --disable-maptool
+
+xcode can now build the navit
+
+
+You can also use CMake.
+
+.. code-block:: bash
+
+ cd navit && cmake -G Xcode .
+
+Something went wrong?
+=====================
+
+Please let us know by filing an issue on Github or reach out on IRC.