X-Git-Url: http://git.tdb.fi/?a=blobdiff_plain;f=README;h=74e4b96ea7f307f16ee5d74f36caa97ddd601ccf;hb=79a866f5b4d51efc15286059ac7e4322b6008eb3;hp=35c9c6913b5eda0422f0407f94f83b26ba3ecbaf;hpb=3a6652634b2152352f6f5a2b9ee3d549140ae337;p=ext%2Fsubsurface.git

diff --git a/README b/README
index 35c9c69..74e4b96 100644
--- a/README
+++ b/README
@@ -4,7 +4,9 @@ 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 need libxml2-devel, gtk2-devel, glib-2.0 and GConf2-devel to build
+this (and libusb-1.0 if you have libdivecomputer built with it, but then
+you obviously already have it installed)
 
 You also need to have libdivecomputer installed, which goes something like this:
 
@@ -15,6 +17,14 @@ You also need to have libdivecomputer installed, which goes something like this:
 	make
 	sudo make install
 
+NOTE! You may need to tell the main Makefile where you installed
+libdivecomputer if you didn't do it in the default /usr/local location.
+I don't trust pkg-config for libdivecomputer, since pkg-config usually
+doesn't work unless the project has been installed by the distro.
+
+Just edit the makefile directly.  autoconf and friends are the devil's
+tools.
+
 Usage:
 
 	make
@@ -22,14 +32,14 @@ Usage:
 
 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
+Or, if you have a dive computer supported by libdivecomputer, you can
+just do
 
 	make
 	./subsurface
 
 and select "Import" from the File menu, tell it what dive computer you
-have, and hit "OK".
+have (and where it is connected if you need to), 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
@@ -37,6 +47,25 @@ and subsurface will de-duplicate the ones that are exactly the same
 the dives have duplicates that were edited by Dirk in the Suunto Dive
 Manager, so they don't trigger the "exact duplicates" match.
 
+Implementation details:
+
+  main.c     - program frame
+  dive.c     - creates and maintaines the internal dive list structure
+  libdivecomputer.c
+  uemis.c
+  parse-xml.c
+  save-xml.c - interface with dive computers and the XML files
+  profile.c  - creates the data for the profile and draws it using cairo
+
+A first UI has been implemented in gtk and an attempt has been made to
+separate program logic from UI implementation.
+
+  gtk-gui.c  - overall layout, main window of the UI
+  divelist.c  - list of dives subsurface maintains
+  equipment.c - equipment / tank information for each dive
+  info.c      - detailed dive info
+  print.c     - printing
+
 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.
@@ -46,11 +75,6 @@ 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