This is the official upstream of the Subsurface divelog program
Find a file
Linus Torvalds 8c18add46b Do libdivecomputer imports in a separate thread
This is the hackiest thing ever, unless you count the previous code that
was even hackier (and just called the gtk main routine at random
places).

The libdivecomputer library is not really set up to be part of the gtk
main loop, and cannot afford (for example) to have lots of mainloop
events while it's parsing.  Some dive computers are very timing
sensitive for the communication.

So just start a thread for doing the libdivecomputer stuff, and just
continually call the gtk main loop while that thread is running.  I'm
sure we could actually use some gtk signalling thing to make the thread
exit do the right thing, but instead we just poll the status every
100ms.

I did say it was hacky.  It does seem to work, though.  No more
temporary graying out of the windows when they don't react in a timely
manner because libdivecomputer does some blocking operation.

Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
2011-09-15 22:58:02 -07:00
dives Make the multi-dive files valid XML 2011-08-28 17:24:53 -07:00
.gitignore Rename the project 'subsurface' 2011-09-15 09:43:14 -07:00
display.h Make the printout look different 2011-09-13 19:49:48 -07:00
dive.c Plot a sick kind of temperature curve 2011-09-12 20:37:32 -07:00
dive.h Support gps coordinates for the location info 2011-09-15 18:16:07 -07:00
divelist.c Update the dive units without destroyng and rebuilding the dive list 2011-09-07 12:05:44 -07:00
divelist.h Libdivecomputer: start actually importing the dive data 2011-09-12 13:25:05 -07:00
equipment.c Separate the notion of creating the cylinder widgets from showing them 2011-09-13 13:50:03 -07:00
info.c Add divemaster/buddy field and text entry 2011-09-13 14:58:06 -07:00
libdivecomputer.c Do libdivecomputer imports in a separate thread 2011-09-15 22:58:02 -07:00
main.c Rename the project 'subsurface' 2011-09-15 09:43:14 -07:00
Makefile Do libdivecomputer imports in a separate thread 2011-09-15 22:58:02 -07:00
parse-xml.c Support gps coordinates for the location info 2011-09-15 18:16:07 -07:00
print.c Make the printout look different 2011-09-13 19:49:48 -07:00
profile.c Print the end temperature of the dive 2011-09-15 09:33:13 -07:00
README Rename the project 'subsurface' 2011-09-15 09:43:14 -07:00
save-xml.c Support gps coordinates for the location info 2011-09-15 18:16:07 -07:00
scripts Start archiving the stupid XML files 2011-08-28 16:18:53 -07:00
uemis.c Fix depth calculations in SDA import 2011-09-15 08:52:55 -07:00
uemis.h First pass to parse uemis Zurich '.SDA' files 2011-09-15 08:52:55 -07:00

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.