summaryrefslogtreecommitdiffstats
path: root/Documentation/user-manual.txt
diff options
context:
space:
mode:
authorGravatar Salvador Cuñat <salvador.cunat@gmail.com>2018-07-13 07:49:01 +0200
committerGravatar Lubomir I. Ivanov <neolit123@gmail.com>2018-07-13 16:18:31 +0300
commit3c1b6d9ec1278544202d6cf2b4711f1cdc7c4cc0 (patch)
treef98bbc68322b760b717b18a3e326845eec2d2c68 /Documentation/user-manual.txt
parentf1ed8748b18537beb6160f8f97ae3dcca0274309 (diff)
downloadsubsurface-3c1b6d9ec1278544202d6cf2b4711f1cdc7c4cc0.tar.gz
[user-manual] Update SmartTrak import information
The information on how to build smtk2ssrf was pretty outdated. Update this information and point to subsurface downloads repo for windows installer and linux appimage. Signed-off-by: Salvador Cuñat <salvador.cunat@gmail.com>
Diffstat (limited to 'Documentation/user-manual.txt')
-rw-r--r--Documentation/user-manual.txt32
1 files changed, 20 insertions, 12 deletions
diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
index 02379fe18..6d3ac4d8e 100644
--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt
@@ -1105,9 +1105,13 @@ using Microsoft Access databases, preventing the integration the importer into t
core application.
A stand alone tool for Linux has been developed to import the _.slg_ files
-generated by SmartTrak to Subsurface's _.xml_ format. It can be built together
-with _Subsurface_ for Linux systems. Two dependencies need to be installed in
-your system before building: _libglib2.0_ and _libmdb2_.
+generated by SmartTrak to Subsurface's _.xml_ format. It can be downloaded
+from https://subsurface-divelog.org/downloads[the usual _Subsurface_ repository],
+as a Windows installer or a Linux AppImage.
+The application is not currently supported on Mac.
+
+It can also be built for Linux systems. Two dependencies need to be met in your
+system before building: _glib2.0_ and _mdbtools_ (see below).
In addition, a web service is available for divelog convertions from SmartTrak to _Subsurface_ (see below).
@@ -1119,15 +1123,19 @@ for assistance in importing _SmartTrak_ dive logs.
Assuming the above dependencies
have been installed and the _Subsurface_ source tree is in the directory _~/src/subsurface_, then:
-- Move to the source tree directory.
-- Run " $ ccmake build " and set SMARTTRAK_IMPORT option to *on* (off by
- default).
-- Generate with [c] and save and exit with [g].
-- Build as you prefer, using the _build.sh_ script (recomended) or moving to build
- directory and running _make_.
-- After a successful build, there will be an executable named _smtk2ssrf_ in the
- _subsurface/build_ directory.
- Copy or move it to a directory in your $PATH, e.g. _~/bin_.
+- Move to the source tree directory out of _Subsurface_ (e.g. ~/src)
+- Run " $ ./subsurface/scripts/smtk2ssrf-build.sh ", if every thing has gone
+ fine, you will now have an executable named smtk2ssrf in
+ ~/src/subsurface/smtk-import/build
+- You can run it from this directory, copy it to another one, e.g. _~/bin_ or
+ simply run "sudo make install", and the binary will be installed in
+ /usr/local/bin (which is commonly included in every $PATH).
+- The script has some options mostly useful for development pourposes. If you
+ think you may need them, please read comments on script header itself.
+- *WARNING*: While building smtk2ssrf, a light version of _Subsurface_ is
+ built (usable but lacking a lot of features). So, if you commonly use the
+ built executable placed at ~/subsurface/build/, you will need to rebuild it as
+ explained in this manual above.
===== Running