From 3f64046f6cac5fd8ac776ae613fbd43e7ab609be Mon Sep 17 00:00:00 2001 From: Florian Hahn Date: Thu, 1 Aug 2013 22:10:38 +0200 Subject: Convert INSTALL.md to reSt --- docs/install.rst | 129 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 129 insertions(+) create mode 100644 docs/install.rst diff --git a/docs/install.rst b/docs/install.rst new file mode 100644 index 00000000..c5fea5d1 --- /dev/null +++ b/docs/install.rst @@ -0,0 +1,129 @@ +Install Instructions +==================== + +Linux +--------- + +First, install the build dependencies :: + + bash apt-get install build-essential libtool autotools-dev automake libconfig-dev ncurses-dev cmake checkinstall + +.. note :: ``libconfig-dev`` should be >= 1.4. + + +Then you'll need a recent version of `libsodium `_ :: + + git clone git://github.com/jedisct1/libsodium.git + cd libsodium + git checkout tags/0.4.2 + ./autogen.sh + ./configure && make check + sudo checkinstall --install --pkgname libsodium --pkgversion 0.4.2 --nodoc + sudo ldconfig`` + +Finally, fetch the Tox source code and run cmake :: + + git clone git://github.com/irungentoo/ProjectTox-Core.git + cd ProjectTox-Core && mkdir build && cd build + cmake .. + +Then you can build any of the files in `/testing`_ and `/other`_ that are currently +supported on your platform by running :: + + make name_of_c_file + +For example, to build `Messenger_test.c`_ you would run :: + + make Messenger_test + + +Or you could just build everything that is supported on your platform by +running :: + bash make + +OS X +------ + +Homebrew +~~~~~~~~~~ +:: + + brew install libtool automake autoconf libconfig libsodium cmake + cmake . + make + sudo make install + +Non-homebrew +~~~~~~~~~~~~ + +Much the same as Linux, remember to install the latest XCode and the +developer tools (Preferences -> Downloads -> Command Line Tools). Users +running Mountain Lion and the latest version of XCode (4.6.3) will also +need to install libtool, automake and autoconf. They are easy enough to +install, grab them from http://www.gnu.org/software/libtool/, +http://www.gnu.org/software/autoconf/ and +http://www.gnu.org/software/automake/, then follow these steps for each: + +:: + + ./configure + make + sudo make install + +Do not install them from macports (or any dependencies for that matter) +as they get shoved in the wrong directory and make your life more +annoying. + +Another thing you may want to install is the latest gcc, this caused me +a few problems as XCode from 4.3 no longer includes gcc and instead uses +LLVM-GCC, a nice install guide can be found at +http://caiustheory.com/install-gcc-421-apple-build-56663-with-xcode-42 + +Windows +--------- + +You should install: + +* `MinGW `_'s C compiler +* `CMake `_ + +You have to `modify your PATH environment +variable `_ so that it +contains MinGW's bin folder path. With default settings, the bin folder +is located at ``C:\MinGW\bin``, which means that you would have to +append ``;C:\MinGW\bin`` to the PATH variable. + +Then you should either clone this repo by using git, or just download a +`zip of current Master +branch `_ +and extract it somewhere. + +After that you should get precompiled package of libsodium from +`here `_ +and extract the archive into this repo's root. That is, ``sodium`` +folder should be along with ``core``, ``testing`` and other folders. + +Navigate in ``cmd`` to this repo and run:: + + mkdir build && cd build + cmake -G "MinGW Makefiles" .. + +Then you can build any of the `/testing`_ and `/other`_ that are currently +supported on your platform by running:: + + mingw32-make name_of_c_file + +For example, to build `Messenger_test.c`_ you would run:: + + mingw32-make Messenger_test`` + +Or you could just build everything that is supported on your platform by +running:: + + mingw32-make + + +.. _/testing: https://github.com/irungentoo/ProjectTox-Core/tree/master/testing +.. _/other: https://github.com/irungentoo/ProjectTox-Core/tree/master/other + +.. _Messenger_test.c: https://github.com/irungentoo/ProjectTox-Core/tree/master/other/Messanger_test.c -- cgit v1.2.3