mirror of
https://github.com/subsurface/subsurface.git
synced 2024-11-28 13:10:19 +00:00
3a6652634b
I never really liked 'diveclog' as a name - it's not like the C part is all that important. And while I could try to just make up another slang word for despicable person (in the tradition of naming all my projects after myself), I just can't see it. So let's just call it "subsurface". Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
90 lines
3.2 KiB
Text
90 lines
3.2 KiB
Text
Half-arsed divelog software in C.
|
|
|
|
I'm tired of java programs that don't work etc.
|
|
|
|
License: GPLv2
|
|
|
|
You need libxml2-devel, gtk2-devel and GConf2-devel to build this.
|
|
|
|
You also need to have libdivecomputer installed, which goes something like this:
|
|
|
|
git clone git://libdivecomputer.git.sourceforge.net/gitroot/libdivecomputer/libdivecomputer
|
|
cd libdivecomputer
|
|
autoreconf --install
|
|
./configure
|
|
make
|
|
sudo make install
|
|
|
|
Usage:
|
|
|
|
make
|
|
./subsurface dives/*.xml
|
|
|
|
to see my dives (with no notes or commentary).
|
|
|
|
Or, if you have a dive computer supported by libdivecomputer (and
|
|
connected to /dev/ttyUSB0), you can just do
|
|
|
|
make
|
|
./subsurface
|
|
|
|
and select "Import" from the File menu, tell it what dive computer you
|
|
have, and hit "OK".
|
|
|
|
There's a lot of duplicates in the XML files that come as an example,
|
|
and subsurface will de-duplicate the ones that are exactly the same
|
|
(just because they were imported multiple times). But at least two of
|
|
the dives have duplicates that were edited by Dirk in the Suunto Dive
|
|
Manager, so they don't trigger the "exact duplicates" match.
|
|
|
|
WARNING! I wasn't kidding when I said that I've done this by reading
|
|
gtk2 tutorials as I've gone along. If somebody is more comfortable with
|
|
gtk, feel free to send me (signed-off) patches.
|
|
|
|
Just as an example of the extreme hackiness of the code, I don't even
|
|
bother connecting a signal for the "somebody edited the dive info"
|
|
cases. I just save/restore the dive info every single time you switch
|
|
dives. Christ! That's truly lame.
|
|
|
|
Also, I don't actually integrate directly with libdivecomputer, I just
|
|
read the XML files it can spit out. But I included my own raw dive
|
|
profile xml files for anybody who isn't a diver, but decides that they
|
|
want to educate me in gtk.
|
|
|
|
NOTE! Some of the dives are pretty pitiful. All the last dives are from
|
|
my divemaster course, so they are from following open water students
|
|
along (many of them the confined*water dives). There a lot of the
|
|
action is at the surface, so some of the "dives" are 4ft deep and 2min
|
|
long.
|
|
|
|
Contributing:
|
|
|
|
Please either send me signed-off patches or a pull request with
|
|
signed-off commits. If you don't sign off on them, I will not accept
|
|
them. This means adding a line that says "Signed-off-by: Name <email>"
|
|
at the end of each commit, indicating that you wrote the code and have
|
|
the right to pass it on as an open source patch.
|
|
|
|
See: http://gerrit.googlecode.com/svn/documentation/2.0/user-signedoffby.html
|
|
|
|
Also, please write good git commit messages. A good commit message
|
|
looks like this:
|
|
|
|
header line: explaining the commit in one line
|
|
|
|
Body of commit message is a few lines of text, explaining things
|
|
in more detail, possibly giving some background about the issue
|
|
being fixed, etc etc.
|
|
|
|
The body of the commit message can be several paragrahps, and
|
|
please do proper word-wrap and keep columns shorter than about
|
|
74 characters or so. That way "git log" will show things
|
|
nicely even when it's indented.
|
|
|
|
Reported-by: whoever-reported-it
|
|
Signed-off-by: Your Name <youremail@yourhost.com>
|
|
|
|
where that header line really should be meaningful, and really should be
|
|
just one line. That header line is what is shown by tools like gitk and
|
|
shortlog, and should summarize the change in one readable line of text,
|
|
independently of the longer explanation.
|