From 80e7213582c203a128270a0e2e8fcc850eede063 Mon Sep 17 00:00:00 2001 From: Dirk Hohndel Date: Wed, 26 Aug 2015 11:44:56 -0700 Subject: Update INSTALL and build.sh They now reference the Subsurface-branch branches of Marble and libdivecomputer and v0.23.1 of libgit2. Signed-off-by: Dirk Hohndel --- INSTALL | 32 ++++++++++++++++++++++---------- 1 file changed, 22 insertions(+), 10 deletions(-) (limited to 'INSTALL') diff --git a/INSTALL b/INSTALL index 89ab1d195..cf35f78c9 100644 --- a/INSTALL +++ b/INSTALL @@ -20,11 +20,25 @@ these from git://git.subsurface-divelog.org/marble (in the Subsurface-4.4 branch) git://git.subsurface-divelog.org/libdc (in the Subsurface-4.4 branch) -Both of these repositories also have a Subsurface-testing branch. That -branch is explicitly marked as NOT STABLE and will receive force pushes. +Both of these repositories also have a Subsurface-branch branch. That +branch is intended for developers trying to track our development here. +It won't have a pretty history and will include ugly merges, but it should +always allow a fast forward pull that tracks what we believe developers +should build again. + +In contrast to that both repositories also have Subsurface-clean branches. +These should allow distros to see which patches we have applied on top of +upstream. They will receive force pushes as we rebase to newer versions of +upstream so they are not ideal for ongoing development (but they are of +course easy to use for distributions as they always build "from scratch", +anyway). + The rationale for this is that we have no intention of forking either of these two projects. We simply are adding a few patches on top of their -latest versions and so those testing branches get frequently rebased. +latest versions and want to do so in a manner that is both easy for our +developers who try to keep them updated frequently, and anyone packaging +Subsurface or trying to understand what we have done relative to their +respective upstreams. Also, all of the prebuilt binaries are now Qt5 based and Qt5 is considered the stable and supported framework to use for building Subsurface. As of @@ -225,11 +239,11 @@ The best way to get libdivecomputer to build appears to be $ mkdir -p ~/src $ 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 + # or -b Subsurface-branch to get the development version + # # -> when not building a release version of Subsurface but the # latest master, it may be necessary to build against the - # Subsurface-testing branch + # Subsurface-branch branch $ cd libdivecomputer $ autoreconf --install @@ -241,8 +255,7 @@ To compile Marble, use: $ 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 + # or -b Subsurface-branch to get the development version $ mkdir marble-build $ cd marble-build @@ -255,13 +268,12 @@ $ mingw64-make # <- this step will take quite a while... if you have more cores # try ming64-make -j8 or something like that $ sudo mingw64-make install - To compile libgit2, use: $ git clone git://github.com/libgit2/libgit2 ~/src/libgit2 $ mkdir ~/src/libgit2/build $ cd ~/src/libgit2 -$ git checkout v0.21.5 +$ git checkout v0.23.1 $ cd build $ mingw64-cmake .. $ mingw64-make -- cgit v1.2.3-70-g09d2