This is the official upstream of the Subsurface divelog program
Find a file
Linus Torvalds ed6356f7d9 Make the notebook portion (dive notes/equipment/info) a scrollable window
This makes things start up with the wrong size, which is somewhat
annoying, but by doing so avoids a bigger annoyance, namely that the
three panes move around when moving between dives.

In particular, if the initial dive didn't have much of an equipment
list, the initial size allocated for the notebook is fairly small and
determined mainly by the size of the the Dive Notes page.  However, when
you then scroll around in the dive list, you might hit a dive with lots
of equipment, and suddenly the panes dividing the different parts of the
subsurface application window will jump around to make room.

That's horribly annoying, and actually makes things like double-clicking
dives in the dive list not work right, because the first click will
select it, and cause the dive to move around (so the second click will
hit a totally different dive).

Now, making the notebook be in a scrollable window means that if the
size of the notebook changes, it might get a scrollbar, but the panes
themselves do not move around.

The initial sizing of that thing being wrong is annoying, though.  We
need to figure out a separate solution to that.

[ Side note: currently it uses GTK_POLICY_NEVER for the horizontal
  scroll-bar, just to avoid the horizontal size also starting out wrong,
  which is *really* nasty.  If we can solve the initial size issue, we
  should make the horizontal scroll-bar be GTK_POLICY_AUTOMATIC too. ]

Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
2012-08-18 14:37:43 -07:00
dives Add three more trimix test dives 2011-12-12 10:12:29 -08:00
Documentation user-manual: fix a few annoying typos 2012-03-22 12:34:41 +01:00
packaging More Mac improvements 2012-01-03 20:19:57 +01:00
xslt Add weight and suit support for JDiveLog import 2012-08-18 09:53:32 -07:00
.gitignore Rename the project 'subsurface' 2011-09-15 09:43:14 -07:00
cochran.c Update cochran depth precision: it's in 3-inch increments 2012-06-19 12:13:50 -07:00
color.h Clean up color definitions 2011-12-01 12:14:21 +01:00
display-gtk.h Add a 'Save As' entry in the menu. 2012-08-17 16:39:28 +02:00
display.h Define all colors in one place 2011-11-28 18:19:50 +01:00
dive.c Make fixup_divep robust against insane dive times 2012-08-18 09:02:27 -07:00
dive.h Correct multi-edit equipment update logic 2012-08-18 08:28:52 -07:00
divelist.c Improve divelist group header information 2012-08-18 11:41:11 -07:00
divelist.h Make sure SAC and OTU get recalculated after cylinder info was changed 2011-11-13 15:29:07 -02:00
equipment.c Correct multi-edit equipment update logic 2012-08-18 08:28:52 -07:00
file.c file.c: Fix a file descriptor leak in readfile() 2012-07-12 18:19:47 -07:00
file.h Add some initial cochran CAN file parsing 2012-01-27 12:43:40 -08:00
gpl-2.0.txt Add a copy of the GPL v2 to the project 2011-09-26 11:18:28 -07:00
gtk-gui.c Make the notebook portion (dive notes/equipment/info) a scrollable window 2012-08-18 14:37:43 -07:00
info.c Select better (?) default date for adding new dive 2012-08-18 11:47:29 -07:00
libdivecomputer.c Update to new sane libdivecomputer interfaces 2012-06-22 13:37:39 -07:00
libdivecomputer.h Update for libdivecomputer pkg-config include file changes 2012-07-10 12:33:44 -07:00
linux.c Don't close config file when changing preferences 2012-05-02 10:03:48 -07:00
macos.c Minor Macos menu entry modification fix 2012-08-17 19:54:27 -07:00
main.c Redo dive editing 2012-08-15 15:32:36 -07:00
Makefile Update for libdivecomputer pkg-config include file changes 2012-07-10 12:33:44 -07:00
parse-xml.c Import Divesuit information from DivingLog XML file 2012-08-17 20:22:37 -07:00
print.c Change plot routine to take a drawing_area as argument 2011-10-04 12:14:26 -07:00
profile.c Make fill_missing_tank_pressures robust against missing cylinder info 2012-08-18 09:05:51 -07:00
README Move the "Import" function from the File menu to the Log menu 2012-05-02 12:56:01 -07:00
save-xml.c Add exposure protection tracking 2012-08-14 17:16:00 -07:00
scripts Start archiving the stupid XML files 2011-08-28 16:18:53 -07:00
statistics.c Stop relying on gtk to track which dives are selected 2012-08-16 16:47:49 -07:00
subsurface.1 Fix subsurface manpage - missing description and parsing problem 2012-05-07 10:49:20 -07:00
subsurface.bmp Use Registry on Windows to store preferences 2011-10-28 18:46:53 -07:00
subsurface.desktop Fix subsurface.desktop category entry 2012-05-07 10:49:20 -07:00
subsurface.svg Have "make install" act more as expected for a desktop application 2011-10-11 20:29:06 -07:00
uemis.c Oddly, finishing a sample doesn't require a sample 2012-01-05 08:16:50 -08:00
uemis.h Much nicer implementation of uemis sample parsing - and add events, too 2011-10-03 12:31:56 -07:00
windows.c set subsurface_flush_conf() to no-op in wondows.c 2012-05-05 10:00:10 -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, 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:

	git clone git://libdivecomputer.git.sourceforge.net/gitroot/libdivecomputer/libdivecomputer
	cd libdivecomputer
	autoreconf --install
	./configure
	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
	./subsurface dives/*.xml

to see my dives (with no notes or commentary).

Or, if you have a dive computer supported by libdivecomputer, you can
just do

	make
	./subsurface

and select "Import" from the Log menu, tell it what dive computer you
have (and where it is connected if you need to), and hit "OK".

NOTE! There are often multiple models of dive computers that import
exactly the same way.  If you have a Suunto Gekko, for example, the
import function works fine - even if you don't find the Gekko listed
explicitly.  It has the same import engine as the older Suunto Vyper
(not "Vyper Air").

So check the (incomplete?) list of supported dive computers below, and
see which ones show up together.  If you have the "Aeris Elite T3", for
example, you'd notice that it's in the same group with the "Oceanic Atom
2", and use that choice to import.

Suunto:

 * Solution

 * Eon, Solution Alpha and Solution Nitrox/Vario

 * Vyper, Cobra, Vytec, Vytec DS, D3, Spyder, Gekko, Mosquito, Stinger and Zoop

 * Vyper2, Cobra2, Cobra3, Vyper Air and HelO2

 * D9, D6 and D4

Uwatec:

 * Aladin

 * Memomouse

 * Smart and Galileo (infrared)

Reefnet:

 * Sensus

 * Sensus Pro

 * Sensus Ultra

Oceanic, Aeris, Sherwood, Hollis, Genesis and Tusa (Pelagic):

 * VT Pro, Versa Pro, Pro Plus 2, Wisdom, Atmos 2, Atmos AI, Atmos
Elite, ...

 * Veo 250, Veo 180Nx, XR2, React Pro, DG02, Insight, ...

 * Atom 2.0, VT3, Datamask, Geo, Geo 2.0, Veo 2.0, Veo 3.0, Pro Plus 2.1,
Compumask, Elite T3, Epic, Manta, IQ-900 (Zen), IQ-950 (Zen Air),
IQ-750 (Element II), ...

Mares:

 * Nemo, Nemo Excel, Nemo Apneist, ...

 * Puck, Puck Air, Nemo Air, Nemo Wide, ...

 * Icon HD

Heinrichs Weikamp:

 * OSTC, OSTC Mk.2 and OSTC 2N

Cressi, Zeagle and Mares (Seiko):

 * Edy, Nemo Sport

 * N2iTiON3

Atomic Aquatics:

 * Cobalt


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.

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.

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 paragraphs, 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.