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 diff --git a/scripts/build.sh b/scripts/build.sh index 64a92f678..6fe361fb7 100755 --- a/scripts/build.sh +++ b/scripts/build.sh @@ -78,8 +78,8 @@ fi cd libgit2 # let's build with a recent enough version of master for the latest features git pull origin master -if ! git checkout c11daac9de2 ; then - echo "Can't find the right commit in libgit2 - giving up" +if ! git checkout v0.23.1 ; then + echo "Can't find the right tag in libgit2 - giving up" exit 1 fi mkdir -p build @@ -106,13 +106,13 @@ if [ ! -d libdivecomputer ] ; then if [[ $1 = local ]] ; then git clone $SRC/../libdivecomputer libdivecomputer else - git clone -b Subsurface-testing git://subsurface-divelog.org/libdc libdivecomputer + git clone -b Subsurface-branch git://subsurface-divelog.org/libdc libdivecomputer fi fi cd libdivecomputer git pull --rebase -if ! git checkout Subsurface-testing ; then - echo "can't check out the Subsurface-testing branch of libdivecomputer -- giving up" +if ! git checkout Subsurface-branch ; then + echo "can't check out the Subsurface-branch branch of libdivecomputer -- giving up" exit 1 fi if [ ! -f configure ] ; then @@ -130,13 +130,13 @@ if [ ! -d marble-source ] ; then if [[ $1 = local ]] ; then git clone $SRC/../marble-source marble-source else - git clone -b Subsurface-testing git://subsurface-divelog.org/marble marble-source + git clone -b Subsurface-branch git://subsurface-divelog.org/marble marble-source fi fi cd marble-source git pull --rebase -if ! git checkout Subsurface-testing ; then - echo "can't check out the Subsurface-testing branch of marble -- giving up" +if ! git checkout Subsurface-branch ; then + echo "can't check out the Subsurface-branch branch of marble -- giving up" exit 1 fi mkdir -p build