summaryrefslogtreecommitdiffstats
path: root/INSTALL
diff options
context:
space:
mode:
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL84
1 files changed, 19 insertions, 65 deletions
diff --git a/INSTALL b/INSTALL
index 3cf459036..3cc8f73a8 100644
--- a/INSTALL
+++ b/INSTALL
@@ -10,8 +10,7 @@ Below are instructions for building Subsurface under some popular
Linux distributions, for building Subsurface using Homebrew on a Mac,
and for cross-building Subsurface for Windows. The lack of a working
package management system for Windows makes it really painful to build
-Subsurface natively under Windows, we have some hints how to do so
-here as well.
+Subsurface natively under Windows, so we don't support that at all.
All of the prebuilt binaries that we provide (right now Windows, Mac,
Ubuntu/Debian/LinuxMint, and openSUSE/Fedora) are built using our own
@@ -96,75 +95,30 @@ sudo apt-get install git g++ make autoconf libtool cmake pkg-config \
libqt5webkit5-dev libqt5qml5 libqt5quick5 libqt5declarative5 \
qtscript5-dev
-On Debian style distributions you can install the required development
-packages by running (once Qt version of subsurface is available in your
-distribution)
-$ sudo apt-get build-dep subsurface
-but on many of them this will give you the build dependencies for the
-official package (which is often way out of date). So be careful that this
-doesn't get you a Qt4 based environment
+On PCLinuxOS you appear to need the following packages
+su -c "apt-get install -y autoconf automake cmake libtool gcc-c++ git \
+lib64usb1.0-devel lib64zip-devel lib64qt5webkitwidgets-devel qttools5 \
+qttranslations5 lib64qt5xml-devel lib64qt5test-devel lib64qtscript-devel \
+lib64qt5svg-devel lib64qt5concurrent-devel"
-First you need to compile our version of libdivecomputer:
+In order to build Subsurface, use the supplied build script. This should
+work on most systems that have all the prerequisite packages installed...
-$ mkdir ~/src # unless you have this already
-$ cd ~/src
-$ git clone -b Subsurface-4.4 git://subsurface-divelog.org/libdc libdivecomputer
- # or -b Subsurface-testing to get the testing version - careful,
- # careful - this gets rebased and may be broken
- # -> when not building a release version of Subsurface but the
- # latest master, it may be necessary to build against the
- # Subsurface-testing branch
-
-$ cd libdivecomputer
-$ autoreconf --install
-$ ./configure --disable-shared
-$ make
-$ sudo make install
-
-Then you compile our custom branch of libmarblewidget
-
-$ cd ~/src
-$ git clone -b Subsurface-4.4 git://subsurface-divelog.org/marble marble-source
- # or -b Subsurface-testing to get the testing version - careful,
- # careful - this gets rebased and may be broken
-
-$ mkdir marble-build
-$ cd marble-build
-$ cmake -DQTONLY=ON -DQT5BUILD=ON \
- -DBUILD_MARBLE_APPS=OFF -DBUILD_MARBLE_EXAMPLES=OFF \
- -DBUILD_MARBLE_TESTS=OFF -DBUILD_MARBLE_TOOLS=OFF \
- -DBUILD_TESTING=OFF -DWITH_DESIGNER_PLUGIN=OFF \
- -DBUILD_WITH_DBUS=OFF ../marble-source
-$ make # <- this step will take quite a while... if you have more cores
- # try make -j8 or something like that
-$ sudo make install
-
-Finally you can compile Subsurface:
-
-$ cd ~/src
-$ git clone git://subsurface-divelog.org/subsurface.git
-$ cd subsurface
-$ git checkout v4.4 # this get's you the last release
- # skip this step to build the latest development
- # version
-$ qmake SPECIAL_MARBLE_PREFIX=1
-# on Fedora/OpenSUSE you need qmake-qt5
-$ make
-$ sudo make install # [optionally, add: prefix=/usr/local]
-
-At least on Fedora and OpenSUSE you need to make sure that /usr/local/lib
-is searched for shared libraries (this is where the steps above installed
-libdivecomputer and libmarblewidget in order not to conflict with system
-pacakges). So you need to do the following:
+You should have Subsurface sources checked out in a sane place, something
+like this:
-$ sudo echo "/usr/local/lib" > /etc/ld.so.conf.d/local.conf
-$ sudo ldconfig
+mkdir -p ~/src
+cd ~/src
+git clone -b v4.4.1 git://subsurface-divelog.org/subsurface
+./subsurface/scripts/build.sh # <- this step will take quite a while as it
+ # compiles a handful of libraries before
+ # building Subsurface
-Now you should be able to start the Subsurface binary you just created
-with
+Now you can run Subsurface like this:
-$ ./subsurface
+cd ~/src/subsurface
+./subsurface
Building Subsurface under MacOSX (using Homebrew)