aboutsummaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorGravatar Linus Torvalds <torvalds@linux-foundation.org>2011-09-03 08:53:05 -0700
committerGravatar Linus Torvalds <torvalds@linux-foundation.org>2011-09-03 08:53:05 -0700
commitf8e39675cccd01b4b76d88b0f9bef922fce3e8f3 (patch)
treecb882aae2cfeef1a330f42573ceb469e4656a9a1 /README
parent3def2b1aacd9c018f1bfe9b7f8bce467239cc3b0 (diff)
downloadsubsurface-f8e39675cccd01b4b76d88b0f9bef922fce3e8f3.tar.gz
Update README a bit
..since this is now on github, might as well tell people what they need to compile it, and warn them about the state of the project. Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
Diffstat (limited to 'README')
-rw-r--r--README37
1 files changed, 36 insertions, 1 deletions
diff --git a/README b/README
index 946beffcc..0ff77c375 100644
--- a/README
+++ b/README
@@ -1,5 +1,40 @@
Half-arsed divelog software in C.
-I'm tired of java programs that don't work etc.
+I'm tired of java programs that don't work etc.
License: GPLv2
+
+You need libxml2-devel and gtk2-devel to build this.
+
+Usage:
+
+ make
+ ./divelog dives/*.xml
+
+to see my dives (with no notes or commentary).
+
+There's a lot of duplicates in there, and divelog 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.