summaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorGravatar Dirk Hohndel <dirk@hohndel.org>2013-05-13 10:14:03 -0700
committerGravatar Dirk Hohndel <dirk@hohndel.org>2013-05-13 10:14:03 -0700
commit06712b29e30f9719ae4ce142fa489353a8498e63 (patch)
treed3aa8492f7676660ac392b3cca16ca3781326cab /README
parentdb95261d561e96cfd1d85441d6815a32db55bb82 (diff)
downloadsubsurface-06712b29e30f9719ae4ce142fa489353a8498e63.tar.gz
First stab at updating the REAMDE for 3.1
Signed-off-by: Dirk Hohndel <dirk@hohndel.org>
Diffstat (limited to 'README')
-rw-r--r--README57
1 files changed, 31 insertions, 26 deletions
diff --git a/README b/README
index 39fe65278..b869caa51 100644
--- a/README
+++ b/README
@@ -25,17 +25,17 @@ in more than a dozen languages and well supported by an active
developer community.
One of the major strengths of Subsurface is its support of a wide range
-of dive computers (most common dive computers are supported, a
-detailed list is at
+of dive computers (most common dive computers are supported with the help
+of libdivecomputer); a detailed list is at
http://subsurface.hohndel.org/documentation/supported-dive-computers).
Subsurface can also import existing dive logs from several sources
-including MacDive, Suunto DM3, JDiveLog and divelogs.de. Another
+including MacDive, Suunto DM3/DM4, JDiveLog and divelogs.de. Another
strength is its ability to visualize the depth profile (and, if
available, the tank pressure curve) in very innovative ways that give
the user additional information on relative velocity (and momentary
air consumption) during the dive through the coloring of the graphs.
-The latest public version is Subsurface 3.0, released in February of 2013.
+The latest public version is Subsurface 3.1, released in May of 2013.
License: GPLv2
@@ -51,40 +51,38 @@ You can also browse the sources via gitweb at git.hohndel.org
If you want the latest release (instead of the bleeding edge
development version) you can either get this via
-git checkout v3.0.2 (or whatever the last release is)
+git checkout v3.1 (or whatever the last release is)
if you have already cloned the git repository as shown above or you
can get a tar ball from
-http://subsurface.hohndel.org/downloads/Subsurface-3.0.2.tgz
+http://subsurface.hohndel.org/downloads/Subsurface-3.1.tgz
Building subsurface under Linux
-------------------------------
-You need libxml2-devel, libxslt-devel, gtk2-devel, glib-2.0,
-gconf2-devel, libsoup-devel to build this (and libusb-1.0 if you have
-libdivecomputer built with it, but then you obviously already have it
-installed). Check with your Linux distribution how to install these
-packages.
+You need libxml2-devel, libxslt-devel, gtk2-devel, glib2-devel,
+gconf2-devel, libsoup-devel, osm-gps-map-devel, libsqlite3x-devel, and
+libzip-devel to build this (and libusb-1.0 if you have libdivecomputer
+built with it, but then you obviously already have it installed).
+Check with your Linux distribution how to install these packages.
On Debian the package names are different; try libxml2-dev,
libgtk2.0-dev, libglib2.0-dev, libgconf2-dev, libsoup2.4-dev,
-libsqlite3-dev, libxslt1-dev, libzip-dev, zlib1g-dev.
+libosmgpsmap-dev, libsqlite3-dev, libxslt1-dev, libzip-dev,
+zlib1g-dev.
-To be able to visualise the dives on a map (optional), using GPS
-coordinates, install the osm-gps-map-devel (Fedora) or libosmgpsmap-dev
-(Debian) package. That will be detected and configured at build
-time. The library is used to embed maps in applications that, when
-given GPS co-ordinates, draw a GPS track.
+Note that contrary to earlier versions of Subsurface, starting in v3.1
+XSLT, LIBZIP and OSMGPSMAP are no longer optional but instead are
+required to build.
You also need to have libdivecomputer installed. The current git
versions of Subsurface assume that you use libdivecomputer version
-0.3, which goes something like this:
+0.4, which goes something like this:
-git clone \
-git://libdivecomputer.git.sourceforge.net/gitroot/libdivecomputer/libdivecomputer
+git clone git://git.libdivecomputer.org/libdivecomputer
cd libdivecomputer
-git checkout release-0.3
+git checkout release-0.4
autoreconf --install
./configure
make
@@ -104,6 +102,11 @@ cross builds under Linux (currently on Fedora 17). A shell script to do
that (plus the .nsi file to create the installer with makensis) are
included in the packaging/Windows directory.
+Strangely the developers have failed to make 'https' support work in
+the cross-built Windows binaries. As a workaround at this point the
+cross built Windows binaries use http instead https connections (right
+now this only applies to divelogs.de uploads).
+
The best way to get libdivecomputer to build appears to be
mingw32-configure
@@ -126,8 +129,9 @@ sudo port install gtk2 +quartz py27-pygtk +quartz libusb gtk-osx-application \
automake autoconf libtool libsoup osm-gps-map libzip
Install libdivecomputer:
-git clone git://libdivecomputer.git.sourceforge.net/gitroot/libdivecomputer/libdivecomputer
+git clone git://git.libdivecomputer.org/libdivecomputer
cd libdivecomputer
+git checkout release-0.4
autoreconf --install
LIBUSB_CFLAGS=-I/opt/local/include ./configure
make
@@ -162,24 +166,25 @@ computer you have (and where it is connected if you need to), and hit
The latest list of supported dive computers can be found at
http://subsurface.hohndel.org/documentation/supported-dive-computers/
-At the time of the 3.0 release they were:
+At the time of the 3.1 release they were:
Atomics Aquatics
Cobalt
Cressi / Zeagle / Mares
Edy, Nemo Sport
N2iTiON3
+ Leonardo
Mares
Nemo, Nemo Excel, Nemo Apneist,...
Puck, Puck Air, Nemo Air, Nemo Wide,...
Darwin, Darwin Air, M1, M2, Airlab
Icon HD, Icon HD Net Ready, Nemo Wide 2
Oceanic / Aeris / Sherwood / Hollis / Genesis / Tusa (Pelagic)
- VT Pro, Versa Pro, Pro Plus 2, Wisdom, Atmos 2, Atmos AI, Atmos Elite,...
- Veo 250, Veo 180Nx, XR2, React Pro, DG02, Insight,...
+ VT Pro, Versa Pro, Pro Plus 2, Pro Plus 3, Wisdom, Atmos 2, Atmos AI, Atmos Elite,...
+ Veo 250, Veo 180Nx, XR2, React Pro, React Pro White, DG02, Insight,...
Atom 2.0, VT3, Datamask, Geo, Geo 2.0, Veo 2.0, Veo 3.0, Pro Plus 2.1,
Compumask, Elite T3, Epic, Manta, IQ-900 (Zen), IQ-950 (Zen Air), IQ-750 (Element II),...
Heinrichs Weikamp
- OSTC, OSTC Mk.2, OSTC 2N
+ OSTC, OSTC Mk.2, OSTC 2N, OSTC3
Frog
Reefnet
Sensus