diff options
| author |  Dirk Hohndel <dirk@hohndel.org> | 2014-12-20 11:37:49 -0800 |
|---|---|---|
| committer | Dirk Hohndel <dirk@hohndel.org> | 2014-12-20 11:37:49 -0800 |
| commit | d3f5222270f3c4c3e90533198b199cbc21fb31c8 (patch) | |
| tree | 51849e65b5d308a68317952667f79fd043f7b78b /ReleaseNotes | |
| parent | 7ab71604ece9508d3e3818f43b80cddb66a4ca16 (diff) | |
| download | subsurface-d3f5222270f3c4c3e90533198b199cbc21fb31c8.tar.gz | |
Add Makefile to create ReleaseNotes HTML
Add the first couple of entries for the next version of the ReleaseNotes.
Signed-off-by: Dirk Hohndel <dirk@hohndel.org>
Diffstat (limited to 'ReleaseNotes')
| -rw-r--r-- | ReleaseNotes/Makefile | 45 | ||||
| -rw-r--r-- | ReleaseNotes/ReleaseNotes.html | 1274 | ||||
| -rw-r--r-- | ReleaseNotes/ReleaseNotes.txt | 17 |
3 files changed, 58 insertions, 1278 deletions
diff --git a/ReleaseNotes/Makefile b/ReleaseNotes/Makefile new file mode 100644 index 000000000..bba376022 --- /dev/null +++ b/ReleaseNotes/Makefile @@ -0,0 +1,45 @@ +# +# in order for "normal" developers not to have to install asciidoc (which +# brings in a couple hundred MB of dependencies) we now include both the +# user-manual.txt and a copy of the generated .html file in git +# +# in order to avoid unnecessary thrash with minor version differences, when +# submitting patches to the user manual, only submit the changes to the .txt +# file - the maintainer will recreate the .html.git file + +DOCNAMES = ReleaseNotes + +HTMLDOCS = $(patsubst %,$(OUT)%.html,$(DOCNAMES)) +TEXTDOCS = $(patsubst %,$(OUT)%.text,$(DOCNAMES)) +PDFDOCS = $(patsubst %,$(OUT)%.pdf,$(DOCNAMES)) + +ASCIIDOC = asciidoc +A2X = a2x +BROWSER = firefox +THEME = ../Documentation/compact_subsurface +PWD = $(realpath .) + +all: $(HTMLEDOCS) $(TEXTDOCS) $(PDFDOCS) + +doc: $(HTMLDOCS) + +$(OUT)%.text: %.txt + $(A2X) -f text $< + +$(OUT)%.pdf: %.txt + -$(A2X) --dblatex-opts "-P latex.output.revhistory=0" -f pdf $< + +$(OUT)%.html: %.txt + @echo "if asciidoc isn't found the html file included in the sources is copied" + $(ASCIIDOC) -a toc -a toclevels=3 -a themedir=$(PWD) -a theme=$(THEME) -a stylesdir=$(PWD) \ + -o $@ $< || cp $(<:%.txt=%.html.git) $@ + +# Alternatively:: +$(OUT)$(DOCNAME).xhtml: $(DOCSOURCE) + $(A2X) --icons -f xhtml $< + +show: $(HTMLDOC) + $(BROWSER) $< + +clean: + rm -f *~ *.xml docbook-xsl.css $(HTMLDOCS) $(TEXTDOCS) $(PDFDOCS) diff --git a/ReleaseNotes/ReleaseNotes.html b/ReleaseNotes/ReleaseNotes.html deleted file mode 100644 index c745cde97..000000000 --- a/ReleaseNotes/ReleaseNotes.html +++ /dev/null @@ -1,1274 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" - "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"> -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> -<head> -<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 8.6.9" /> -<title></title> -<style type="text/css"> -/* - * compact_subsurface.css, a special style sheet for Subsurface, - * modified by Willem Ferguson and derived from: - * compact.css, version 1.3 by Alex Efros <powerman@powerman.name> - * Licence: Public Domain - * - * Usage: asciidoc -a theme=compact_subsurface ... - */ - -* { padding: 0; margin: 0; } -img { border: 0; } - -/*** Layout ***/ - -body { margin: 10px 20px; } -#header br { display: none; } -#revnumber { display: block; } -#toc { margin: 1em 0; } -.toclevel2 { margin-left: 1em; } -.toclevel3 { margin-left: 2em; } -#footer { margin-top: 2em; } - -#preamble .sectionbody, -h2, -h3, -h4, -h5 { margin: 1em 0 0 0; } - -.admonitionblock, -.listingblock, -.sidebarblock, -.exampleblock, -.tableblock, -.literalblock { margin: 1em 0; } -.admonitionblock td.icon { padding-right: 0.5em; } -.admonitionblock td.content { padding-left: 0.5em; } -.listingblock .content { padding: 0.5em; } -.sidebarblock > .content { padding: 0.5em; } -.exampleblock > .content { padding: 0 0.5em; } -.tableblock caption { padding: 0 0 0.5em 0; } -.tableblock thead th, -.tableblock tbody td, -.tableblock tfoot td { padding: 0 0.5em; } -.quoteblock { padding: 0 2.0em; } - -.paragraph { margin: 1em 0 0 0; } -.sidebarblock .paragraph:first-child, -.exampleblock .paragraph:first-child, -.admonitionblock .paragraph:first-child { margin: 0; } - - .ulist, .olist, .dlist, .hdlist, .qlist { margin: 1em 0; } -li .ulist, li .olist, li .dlist, li .hdlist, li .qlist, -dd .ulist, dd .olist, dd .dlist, dd .hdlist, dd .qlist { margin: 0; } -ul { margin-left: 1.5em; } -ol { margin-left: 2em; } -dd { margin-left: 3em; } -td.hdlist1 { padding-right: 1em; } - -/*** Fonts ***/ - -body { font-family: Verdana, sans-serif; } -#header { font-family: Arial, sans-serif; } -#header h1 { font-family: Arial, sans-serif; } -#footer { font-family: Georgia, serif; } -#email { font-size: 0.85em; } -#revnumber { font-size: 0.75em; } -#toc { font-size: 0.9em; } -#toctitle { font-weight: bold; } -#footer { font-size: 0.8em; } - -h2, h3, h4, h5, .title { font-family: Arial, sans-serif; } -h2 { font-size: 1.5em; } -.sectionbody { font-size: 0.85em; } -.sectionbody .sectionbody { font-size: inherit; } -h3 { font-size: 159%; } /* 1.35em */ -h4 { font-size: 141%; } /* 1.2em */ -h5 { font-size: 118%; } /* 1em */ -.title { font-size: 106%; /* 0.9em */ - font-weight: bold; - } - -tt, .monospaced { font-family: monospace; font-size: 106%; } /* 0.9em */ -dt, td.hdlist1, .qlist em { font-family: Times New Roman, serif; - font-size: 118%; /* 1em */ - font-style: italic; - } -.tableblock tfoot td { font-weight: bold; } - -/*** Colors and Backgrounds ***/ - -h1 { color: #527bbd; border-bottom: 2px solid silver; } -#footer { border-top: 2px solid silver; } - -h2 { color: #527bbd; border-bottom: 2px solid silver; } -h3 { color: #5D7EAE; border-bottom: 2px solid silver; } -h3 { display: inline-block; } -h4,h5 { color: #5D7EAE; } - -.admonitionblock td.content { border-left: 2px solid silver; } -.listingblock .content { background: #f4f4f4; border: 1px solid silver; border-left: 5px solid #e0e0e0; } -.sidebarblock > .content { background: #ffffee; border: 1px solid silver; border-left: 5px solid #e0e0e0; } -.exampleblock > .content { border-left: 2px solid silver; } -.quoteblock { border-left: 5px solid #e0e0e0; } -.tableblock table { - border-collapse: collapse; - border-width: 3px; - border-color: #527bbd; -} -.tableblock table[frame=hsides] { border-style: solid none; } -.tableblock table[frame=border] { border-style: solid; } -.tableblock table[frame=void] { border-style: none; } -.tableblock table[frame=vsides] { border-style: none solid; } -.tableblock table[rules=all] tbody tr *, -.tableblock table[rules=rows] tbody tr * { - border-top: 1px solid #527bbd; -} -.tableblock table[rules=all] tr *, -.tableblock table[rules=cols] tr * { - border-left: 1px solid #527bbd; -} -.tableblock table tbody tr:first-child * { - border-top: 1px solid white; /* none don't work here... %-[] */ -} -.tableblock table tr *:first-child { - border-left: none; -} -.tableblock table[frame] thead tr *, -.tableblock table[frame] thead tr * { - border-top: 1px solid white; - border-bottom: 2px solid #527bbd; -} -.tableblock table tr td p.table, -.tableblock table tr td p.table * { - border: 0px; -} - -tt, .monospaced { color: navy; } - -li { color: #a0a0a0; } -li > * { color: black; } - -span.aqua { color: aqua; } -span.black { color: black; } -span.blue { color: blue; } -span.fuchsia { color: fuchsia; } -span.gray { color: gray; } -span.green { color: green; } -span.lime { color: lime; } -span.maroon { color: maroon; } -span.navy { color: navy; } -span.olive { color: olive; } -span.purple { color: purple; } -span.red { color: red; } -span.silver { color: silver; } -span.teal { color: teal; } -span.white { color: white; } -span.yellow { color: yellow; } - -span.aqua-background { background: aqua; } -span.black-background { background: black; } -span.blue-background { background: blue; } -span.fuchsia-background { background: fuchsia; } -span.gray-background { background: gray; } -span.green-background { background: green; } -span.lime-background { background: lime; } -span.maroon-background { background: maroon; } -span.navy-background { background: navy; } -span.olive-background { background: olive; } -span.purple-background { background: purple; } -span.red-background { background: red; } -span.silver-background { background: silver; } -span.teal-background { background: teal; } -span.white-background { background: white; } -span.yellow-background { background: yellow; } - -span.big { font-size: 2em; } -span.small { font-size: 0.6em; } - -span.underline { text-decoration: underline; } -span.overline { text-decoration: overline; } -span.line-through { text-decoration: line-through; } - -/*** Misc ***/ - -.admonitionblock td.icon { vertical-align: top; } -.attribution { text-align: right; } - -ul { list-style-type: disc; } -ol.arabic { list-style-type: decimal; } -ol.loweralpha { list-style-type: lower-alpha; } -ol.upperalpha { list-style-type: upper-alpha; } -ol.lowerroman { list-style-type: lower-roman; } -ol.upperroman { list-style-type: upper-roman; } -.hdlist td { vertical-align: top; } - - -</style> -<script type="text/javascript"> -/*<+'])'); - // Function that scans the DOM tree for header elements (the DOM2 - // nodeIterator API would be a better technique but not supported by all - // browsers). - var iterate = function (el) { - for (var i = el.firstChild; i != null; i = i.nextSibling) { - if (i.nodeType == 1 /* Node.ELEMENT_NODE */) { - var mo = re.exec(i.tagName); - if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") { - result[result.length] = new TocEntry(i, getText(i), mo[1]-1); - } - iterate(i); - } - } - } - iterate(el); - return result; - } - - var toc = document.getElementById("toc"); - if (!toc) { - return; - } - - // Delete existing TOC entries in case we're reloading the TOC. - var tocEntriesToRemove = []; - var i; - for (i = 0; i < toc.childNodes.length; i++) { - var entry = toc.childNodes[i]; - if (entry.nodeName.toLowerCase() == 'div' - && entry.getAttribute("class") - && entry.getAttribute("class").match(/^toclevel/)) - tocEntriesToRemove.push(entry); - } - for (i = 0; i < tocEntriesToRemove.length; i++) { - toc.removeChild(tocEntriesToRemove[i]); - } - - // Rebuild TOC entries. - var entries = tocEntries(document.getElementById("content"), toclevels); - for (var i = 0; i < entries.length; ++i) { - var entry = entries[i]; - if (entry.element.id == "") - entry.element.id = "_toc_" + i; - var a = document.createElement("a"); - a.href = "#" + entry.element.id; - a.appendChild(document.createTextNode(entry.text)); - var div = document.createElement("div"); - div.appendChild(a); - div.className = "toclevel" + entry.toclevel; - toc.appendChild(div); - } - if (entries.length == 0) - toc.parentNode.removeChild(toc); -}, - - -///////////////////////////////////////////////////////////////////// -// Footnotes generator -///////////////////////////////////////////////////////////////////// - -/* Based on footnote generation code from: - * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html - */ - -footnotes: function () { - // Delete existing footnote entries in case we're reloading the footnodes. - var i; - var noteholder = document.getElementById("footnotes"); - if (!noteholder) { - return; - } - var entriesToRemove = []; - for (i = 0; i < noteholder.childNodes.length; i++) { - var entry = noteholder.childNodes[i]; - if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote") - entriesToRemove.push(entry); - } - for (i = 0; i < entriesToRemove.length; i++) { - noteholder.removeChild(entriesToRemove[i]); - } - - // Rebuild footnote entries. - var cont = document.getElementById("content"); - var spans = cont.getElementsByTagName("span"); - var refs = {}; - var n = 0; - for (i=0; i<spans.length; i++) { - if (spans[i].className == "footnote") { - n++; - var note = spans[i].getAttribute("data-note"); - if (!note) { - // Use [\s\S] in place of . so multi-line matches work. - // Because JavaScript has no s (dotall) regex flag. - note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1]; - spans[i].innerHTML = - "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n + - "' title='View footnote' class='footnote'>" + n + "</a>]"; - spans[i].setAttribute("data-note", note); - } - noteholder.innerHTML += - "<div class='footnote' id='_footnote_" + n + "'>" + - "<a href='#_footnoteref_" + n + "' title='Return to text'>" + - n + "</a>. " + note + "</div>"; - var id =spans[i].getAttribute("id"); - if (id != null) refs["#"+id] = n; - } - } - if (n == 0) - noteholder.parentNode.removeChild(noteholder); - else { - // Process footnoterefs. - for (i=0; i<spans.length; i++) { - if (spans[i].className == "footnoteref") { - var href = spans[i].getElementsByTagName("a")[0].getAttribute("href"); - href = href.match(/#.*/)[0]; // Because IE return full URL. - n = refs[href]; - spans[i].innerHTML = - "[<a href='#_footnote_" + n + - "' title='View footnote' class='footnote'>" + n + "</a>]"; - } - } - } -}, - -install: function(toclevels) { - var timerId; - - function reinstall() { - asciidoc.footnotes(); - if (toclevels) { - asciidoc.toc(toclevels); - } - } - - function reinstallAndRemoveTimer() { - clearInterval(timerId); - reinstall(); - } - - timerId = setInterval(reinstall, 500); - if (document.addEventListener) - document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false); - else - window.onload = reinstallAndRemoveTimer; -} - -} -asciidoc.install(); -/*]]>*/ -</script> -</head> -<body class="article"> -<div id="header"> -</div> -<div id="content"> -<div class="sect1"> -<h2 id="_em_subsurface_em_4_3_released_december_2014"><em>Subsurface</em> 4.3 - released December 2014</h2> -<div class="sectionbody"> -<div class="paragraph"><p>The <em>Subsurface</em> development team proudly announces -release 4.3 of <em>Subsurface</em>, an open source divelog and dive planning -program for Windows, Mac and Linux.</p></div> -<div class="paragraph"><p>License: GPLv2</p></div> -<div class="paragraph"><p><em>Subsurface</em> can be found at: http://<em>Subsurface</em>-divelog.org</p></div> -<div class="sect2"> -<h3 id="_some_of_the_changes_since_em_subsurface_em_4_2">Some of the changes since <em>Subsurface</em> 4.2</h3> -<div class="paragraph"><p><em>Subsurface</em> now supports flexible filtering of the dive list. When the filter -is opened,one can -specify a combination of different criteria like tags, people who were on -the dive, dive site, suit, etc. While filtering one can see how many dives -match any of the criteria, and how many dives match the combination of the -selected criteria (see the panel below the main menu in the image below)</p></div> -<div class="imageblock" style="text-align:center;"> -<div class="content"> -<img src="images/V4.3_Subsurface_filter.jpg" alt="Subsurface panel" /> -</div> -</div> -<div class="paragraph"><p>When editing a dive, one can now copy information about a dive -and paste it into one or more other dives. This makes it easy to add the -same equipment, buddies, tags or other aspects of a dive into a group of -dives with similar characteristics.</p></div> -<div class="paragraph"><p>The dive profile now offers an easy to understand -tissue saturation graph that shows tissue saturation at any -point during the dive. (See image below)</p></div> -<div class="imageblock" style="text-align:center;"> -<div class="content"> -<img src="images/V4.3_CylBars.jpg" alt="Cylinder bars and tissue saturation graph" /> -</div> -</div> -<div class="paragraph"><p>In the dive profile one can turn on an improved visualization of the -gas combinations used during a dive (aka "tank bar" with different gases represented -by different colours, see image above).</p></div> -<div class="paragraph"><p>Owners of the Heinrichs & Weikamp OSTC 2 and 3 as well as dive computers -in the popular Suunto Vyper family of dive computers can configure the -settings of their dive computers using <em>Subsurface</em>.</p></div> -<div class="paragraph"><p>For a number of dive computers <em>Subsurface</em> now downloads additional data and -shows them in a new tab on the screen. This includes (depending on the -dive computer) information like battery levels, no fly times, Gradient -Factors used during the dive, etc. This feature is enabled in all official -<em>Subsurface</em> binaries and includes the Uemis Zurich SDA. When building -from source this requires a custom -version of libdivecomputer (as explained in the INSTALL file).</p></div> -<div class="paragraph"><p>The dive planner now offers the ability to re-plan dives and to create duplicate -dive plans in order to plan multiple scenarios.</p></div> -<div class="paragraph"><p>We added support for several new dive computers including the Suunto EON -Steel, Aeris A300 CD, and Aeris F11.</p></div> -<div class="paragraph"><p><em>Subsurface</em> can now import dive logs from Liquivision and Cochran software -as well as the new Suuntu DM5.</p></div> -<div class="paragraph"><p>We made many improvements for UDDF and CSV import, UDDF export now -complies with the latest version of the standard.</p></div> -<div class="paragraph"><p>Many issues with the HTML export were addressed.</p></div> -<div class="paragraph"><p>Initial support for closed circuit rebreathers (CCR) and pSCR was added. -Dive logs from the Poseidon MkVI -CCR can be imported. Visualization of dive logs as -well as dive planning should work - but this feature is fairly early in -its development and we assume that there may be a few bugs and -mis-features hidden in this area. Here is a dive profile for a Poseidon MkVI:</p></div> -<div class="imageblock" style="text-align:center;"> -<div class="content"> -<img src="images/V4.3_CCR.jpg" alt="CCR dive profile" /> -</div> -</div> -<div class="paragraph"><p><strong>Other notable improvements</strong></p></div> -<div class="ulist"><ul> -<li> -<p> -Import of manually logged dives (e.g., from an existing paper logbook) - is now much better documented in the user manual. Instead of having to - individually enter each dive with the graphical profile editor users can - add all their dives in a spreadsheet and import the data from there into - <em>Subsurface</em> in one single operation. -</p> -</li> -<li> -<p> -Many other small improvements to the planner -</p> -</li> -<li> -<p> -Many small UI changes for better use on small displays (tighter columns - and column headers on the dive list, the toolbox of icons no longer - forces a minimum height of the profile, etc) -</p> -</li> -<li> -<p> -Improvements on HiDPI displays -</p> -</li> -<li> -<p> -We fixed an annoying bug where when starting to edit a dive the pop-up - with completions would cover the edit line (this usually happened when - editing tags) -</p> -</li> -<li> -<p> -For the (rather unusual) dive computers that send a heading event in - every sample we automatically declutter the profile display now -</p> -</li> -<li> -<p> -The Windows installer is smarter: the 64bit installer refuses to - install its binaries on a 32bit OS and conversely the installer warns - you when installing 32bit binaries on a 64bit OS -</p> -</li> -<li> -<p> -Better synchronization with divelogs.de, including support for multiple - tanks -</p> -</li> -</ul></div> -<div class="paragraph"><p><strong>Known bugs</strong></p></div> -<div class="ulist"><ul> -<li> -<p> -There appears to be a bug in Qt: when changing the password needed - authenticate with a proxy, <em>Subsurface</em> will not use the new password - until after a restart -</p> -</li> -</ul></div> -</div> -</div> -</div> -<div class="sect1"> -<h2 id="_em_subsurface_em_4_2"><em>Subsurface</em> 4.2</h2> -<div class="sectionbody"> -<div class="paragraph"><p>The <em>Subsurface</em> developer team is proud to announce the release of the -next update of <em>Subsurface</em>.</p></div> -<div class="paragraph"><p><em>Subsurface</em> is an open source divelog program that runs on Windows, Mac -and Linux.</p></div> -<div class="paragraph"><p>With <em>Subsurface</em> the user can download dive information directly from a -large number of supported dive computers. <em>Subsurface</em> is able to track -single- and multi-tank dives using air, Nitrox or TriMix. It displays -a dive profile with all related information including air consumption -and alarms. It also allows logging of information like weights and -exposure protection used, dive masters and dive buddies, and enables -the user to rate dives and provide additional dive notes.</p></div> -<div class="paragraph"><p>With <em>Subsurface</em> the user can track dive locations including GPS -coordinates (which can also be conveniently entered using a map -interface). <em>Subsurface</em> calculates a wide variety of statistics of the -user’s diving and keeps track of information like the user’s SAC rate, -partial pressures of O2, N2 and He, calculated deco information, and -many more.</p></div> -<div class="paragraph"><p><em>Subsurface</em> allows the user to print out a detailed log book including -dive profiles and other relevant information. The program is localized -in about 20 languages and well supported by an active developer -community. This community also made new and shiny offline manuals in -Spanish and Russian possible.</p></div> -<div class="paragraph"><p>One of the major strengths of <em>Subsurface</em> is its support of a wide range -of dive computers (most common dive computers are supported with the help -of libdivecomputer); a detailed list is in the SupportedDivecomputers.txt -file. <em>Subsurface</em> can also import existing dive logs from several sources -including MacDive, Suunto DM3/DM4, JDiveLog and divelogs.de. Another -strength is its ability to visualize the depth profile (and, if -available, the tank pressure curve) in very innovative ways that give -the user additional information on relative velocity (and momentary -air consumption) during the dive through the coloring of the graphs.</p></div> -<div class="paragraph"><p><strong>Some of the changes since 4.1</strong></p></div> -<div class="ulist"><ul> -<li> -<p> -The Windows installer is now a 64bit installer including Qt5 -</p> -</li> -<li> -<p> -There is still a deprecated 32bit installer including Qt4, but that has - several known issues (among others, printing has a number of bugs that - were fixed in Qt5). -</p> -</li> -<li> -<p> -The Mac installer has also been updated to Qt5 -</p> -</li> -<li> -<p> -A current development version of libdivecomputer is used for the Windows - and Mac builds. -</p> -</li> -<li> -<p> -A Dive Planner got added again, using the graphical profile editor; it - supports different ascent speeds, backgas breaks during deco and many - other interesting features; it allows the user to print just the dive - plan (without graphic profile); one shortcoming is that currently one - cannot re-plan a planned dive, i.e., once you save a dive plan, you can - no longer edit / change the plan; you have to start from scratch again. - This is on the todo list. -</p> -</li> -<li> -<p> -Pictures can be associated with dives and shown in the profile -</p> -</li> -<li> -<p> -Printing is much improved (but see above), including a "1 dive per page" - mode, better rendering of dives (in our mind) and better data - presented per dive. -</p> -</li> -<li> -<p> -Data entry for dives is much more intuitive and consistent -</p> -</li> -<li> -<p> -We have a reasonably functional HTML exporter for the dive log (it’s - still work in progress but already quite powerful, even though lacking - localization support). -</p> -</li> -<li> -<p> -Support to import dive log files from Seabear dive computers. -</p> -</li> -<li> -<p> -We added a user survey to learn more about the interests and needs of - out users -</p> -</li> -<li> -<p> -improved and extended user manuals -</p> -</li> -<li> -<p> -new translated user manuals in Spanish and Russian -</p> -</li> -</ul></div> -<div class="paragraph"><p><strong>Known issues:</strong></p></div> -<div class="ulist"><ul> -<li> -<p> -(Windows specific) Many Windows fonts don’t support specific characters, - specifically subscript "2" (eg in pO₂). New installations of <em>Subsurface</em> - will automatically pick a font that contains this character, but if you - had <em>Subsurface</em> installed on a specific system before, it likely has - saved the previous font in its settings. In that case the best solution - is to manually change the font to one that contains this character, - e.g. Calibri. -</p> -</li> -<li> -<p> -(Windows specific) When upgrading from <em>Subsurface</em> 4.1, after saving of a - logfile the logfile’s name may be listed a second time in the files menu - because of a change in the representation of logfiles filename in the - Windows registry. -</p> -</li> -<li> -<p> -There are a number of small inconsistencies in the UI when editing - multiple dives. For example, if multiple dives are edited and some of - them already have coordinates set, under certain circumstances the - changes aren’t saved. To circumvent this bug only edit dives with the - same coordinates or edit the dives individually. -</p> -</li> -<li> -<p> -(Windows specific - only 64bit) If an ad blocker is used and set to - offline mode, the manual check for an update crashes <em>Subsurface</em>. -</p> -</li> -<li> -<p> -When using the globe / map widget to edit dive locations, double clicks - some times fail to set the correct position. -</p> -</li> -<li> -<p> -Sometimes the globe will show the same pane several times. Try to zoom - in or out of the location and give the system time to download the map - tiles in the background - on slower network connections this can take a - while. -</p> -</li> -</ul></div> -<div class="sect2"> -<h3 id="_new_in_version_4_1_compared_to_em_subsurface_em_4_0_3">New in version 4.1 (compared to <em>Subsurface</em> 4.0.3):</h3> -<div class="ulist"><ul> -<li> -<p> -new and improved profile widget with animations, better info box, and - a new toolbox to turn on and off many of the additional graphs and - information displays -</p> -</li> -<li> -<p> -improved CSV import and added CSV export -</p> -</li> -<li> -<p> -import of exported log files from Sensus (CSV) and Shearwater Desktop - (XML) -</p> -</li> -<li> -<p> -improved UDDF and divelogs.de support -</p> -</li> -<li> -<p> -generalized import dialog -</p> -</li> -<li> -<p> -much improved consistency for dialog boxes, keyboard shortcuts, etc -</p> -</li> -<li> -<p> -improved error handling when downloading from divecomputer -</p> -</li> -<li> -<p> -export an HTML world map with dive sites -</p> -</li> -<li> -<p> -make backups before overwriting XML files -</p> -</li> -<li> -<p> -don’t display unused cylinders in the equipment tab (this can be turned - off and the old behavior restored in the preferences) -</p> -</li> -<li> -<p> -lots of code cleanup, style fixes, improved consistency -</p> -</li> -<li> -<p> -improve Qt5 support (but there are still some visual oddities) -</p> -</li> -<li> -<p> -many improvements to the build infrastructure (out of tree builds, - ability to build without Marble, make WIP planner a config option) -</p> -</li> -<li> -<p> -more than 50 bugs fixed -</p> -</li> -<li> -<p> -new translation (Greek, British-English, Latvian, and Romanian) -</p> -</li> -<li> -<p> -experimental "check for updates" feature (mostly for Windows and Mac) -</p> -</li> -<li> -<p> -experimental undocumented alternative storage format -</p> -</li> -</ul></div> -</div> -<div class="sect2"> -<h3 id="_new_in_version_4_0_3_compared_to_em_subsurface_em_4_0_2">New in version 4.0.3 (compared to <em>Subsurface</em> 4.0.2):</h3> -<div class="ulist"><ul> -<li> -<p> -fixed unitinialized variable bug that caused errors downloading from - divecomputers -</p> -</li> -</ul></div> -</div> -<div class="sect2"> -<h3 id="_new_in_version_4_0_2_compared_to_em_subsurface_em_4_0_1">New in version 4.0.2 (compared to <em>Subsurface</em> 4.0.1):</h3> -<div class="ulist"><ul> -<li> -<p> -fixed potential crash when importing dive data without dive computer - model information -</p> -</li> -<li> -<p> -improve parsing of equipment data; this now accepts localized units - as well as input in units that are not the display units (so if you - run <em>Subsurface</em> in metric, but went diving in a place where weights - are in US Pounds (lbs), you can now enter the weight in lbs and - <em>Subsurface</em> does the right thing) -</p> -</li> -<li> -<p> -fix temperature conversion when downloading data from Uemis SDA -</p> -</li> -<li> -<p> -improve autocompletion to always be case insensitive -</p> -</li> -<li> -<p> -improve selection handling in the dive list -</p> -</li> -<li> -<p> -include event data in libdivecomputer dump -</p> -</li> -<li> -<p> -improve profiles generated for dives with no depth samples and no - average depth -</p> -</li> -</ul></div> -</div> -<div class="sect2"> -<h3 id="_new_in_version_4_0_1_compared_to_em_subsurface_em_4_0">New in version 4.0.1 (compared to <em>Subsurface</em> 4.0):</h3> -<div class="ulist"><ul> -<li> -<p> -fixed several bugs handling non-ASCII text both in dive info text - fields as well as in Windows file names -</p> -</li> -<li> -<p> -added support for generating libdivecomputer log and dump files -</p> -</li> -<li> -<p> -many improvements for import and export of other file formats -</p> -</li> -<li> -<p> -XSLT files are built-in as resources, avoiding issues with not - finding them -</p> -</li> -<li> -<p> -support more GPS coordinate formats -</p> -</li> -<li> -<p> -fixed several bugs around editing of manually entered dives -</p> -</li> -<li> -<p> -fixed several bugs with entering data for weights and tanks -</p> -</li> -<li> -<p> -increase the number of tracked weight systems to 6 -</p> -</li> -<li> -<p> -fixed font setting in preferences -</p> -</li> -<li> -<p> -improved look and feel when running dark themes -</p> -</li> -<li> -<p> -support older versions of Mac OS/X with default DMG (>= 10.5) -</p> -</li> -<li> -<p> -enable https in Windows binaries -</p> -</li> -</ul></div> -</div> -<div class="sect2"> -<h3 id="_new_in_version_4_0_compared_to_em_subsurface_em_3_1">New in version 4.0 (compared to <em>Subsurface</em> 3.1):</h3> -<div class="paragraph"><p>With version 4.0 the <em>Subsurface</em> team switched to a different UI -toolkit. This caused the need to do a complete rewrite of a large -chunk of the <em>Subsurface</em> code base. We decided to keep much of the -logic and core of the existing code around, but used the opportunity -for quite a bit of cleanup and many improvements.</p></div> -<div class="paragraph"><p>The basic concepts are the same, most of the basic features are the -same, but trying to create a concise list of changes that summarizes -the more than 1600 commits that have gone in since version 3.1 seems a -daunting task.</p></div> -<div class="paragraph"><p><strong>Here are some of the highlights:</strong></p></div> -<div class="ulist"><ul> -<li> -<p> -new map widget with a spinning globe to visualize dive locations -</p> -</li> -<li> -<p> -much more "native" look and feel under Windows and Mac -</p> -</li> -<li> -<p> -ability to edit dives "in place": simply click on an entry in the - Dive Notes or Equipment tabs to start editing -</p> -</li> -<li> -<p> -more data about each dive is presented in the Dive Notes and can - be edited without separate dialogs and without having to go through - context menues -</p> -</li> -<li> -<p> -graphical editor for dive profiles for manually added dives -</p> -</li> -<li> -<p> -better information overlay for the dive profile -</p> -</li> -<li> -<p> -addition of a "ruler" tool in the profile window that allows - measuring of many properties between two points in the profile -</p> -</li> -<li> -<p> -better tag system with both predefined user-specified free text tags -</p> -</li> -<li> -<p> -better integration with divelogs.de (upload & download support) -</p> -</li> -<li> -<p> -ability to show the user manual from within the application without - a life internet connection and without opening the manual in an - external browser window -</p> -</li> -<li> -<p> -better statistics (with per-trip statistics available) -</p> -</li> -</ul></div> -<div class="paragraph"><p><strong>Known issues:</strong></p></div> -<div class="ulist"><ul> -<li> -<p> -Filter→Select Events is not implemented -</p> -</li> -<li> -<p> -Dive planner has been disabled for now -</p> -</li> -<li> -<p> -https support for divelogs.de on Windows is disabled -</p> -</li> -</ul></div> -</div> -<div class="sect2"> -<h3 id="_new_in_version_3_1_compared_to_em_subsurface_em_3_0_2">New in version 3.1 (compared to <em>Subsurface</em> 3.0.2):</h3> -<div class="ulist"><ul> -<li> -<p> -track tags for dives (things like <em>boat</em>, <em>shore</em>, <em>deep</em>, etc) -</p> -</li> -<li> -<p> -enable filtering by tags -</p> -</li> -<li> -<p> -ability to modify events from a context menu in the dive profile - (this includes the ability to add gaschange events) -</p> -</li> -<li> -<p> -direct export / upload to the divelogs.de online logbook -</p> -</li> -<li> -<p> -import of Suunto DM4 files -</p> -</li> -<li> -<p> -improved printout formatting and printer dialog -</p> -</li> -<li> -<p> -support for color printing -</p> -</li> -<li> -<p> -dive planning: add option for last stop at 6m/20ft -</p> -</li> -<li> -<p> -added support for Heinrichs Weikamp OSTC3 and Suunto DX -</p> -</li> -<li> -<p> -native support for the Shearwater Petrel (much faster download) -</p> -</li> -<li> -<p> -various bug fixes -</p> -</li> -</ul></div> -</div> -<div class="sect2"> -<h3 id="_new_in_version_3_0_2_compared_to_em_subsurface_em_3_0_1">New in version 3.0.2 (compared to <em>Subsurface</em> 3.0.1):</h3> -<div class="paragraph"><p>This update was mainly triggered by a bug in the handling of pO₂ -values read from CCR / rebreather dive computers. This bug can lead to -incorrect data being stored in the <em>Subsurface</em> XML file. Installing -<em>Subsurface</em> 3.0.2 and re-downloading the dives will correct the -incorrect data. In order to re-download the dives connect your dive -computer (this should only affect people with certain tec dive -computers like the Shearwater Petrel or Predator that store pO₂ values -read from a pO₂ sensor in their dive log), open the download dialog, -check the box "Force download of all dives" and download your -dives. After you save your data file the correct pO₂ data should be -stored in the samples.</p></div> -<div class="paragraph"><p>If you are using one of those dive computers, have saved data files -with <em>Subsurface</em> 3.0 or 3.0.1 and have since deleted those dives from -your dive computers, please contact the developers as we also have an -experimental script that should be able to fix incorrect XML files - -but re-downloading the data is the much more reliable way to address -this issue.</p></div> -<div class="paragraph"><p>In addition to this bug fix, 3.0.2 brings a number of other improvements: -- A Portuguese localization of <em>Subsurface</em> was added. -- <em>Subsurface</em> now remembers its window size and pane layout the next time - it is started. -- Several importers for data for third party dive software were improved. -- Dives from the Heinrichs & Weikamp DR5 and from kenozooid can now be - imported into <em>Subsurface</em>. -- A crash with localized versions of <em>Subsurface</em> on Mac was resolved. -- The map provider for the GPS maps is now configurable. -- The layout of some dialog boxes was changed to improve usability on - small screens. -- It is now easier to edit date and time of existing dives (and you can - now edit duration, maximum and average depth for dives that were - manually entered). -- Several small bugs were addressed.</p></div> -</div> -<div class="sect2"> -<h3 id="_new_in_version_3_0_1_compared_to_em_subsurface_em_3_0">New in version 3.0.1 (compared to <em>Subsurface</em> 3.0):</h3> -<div class="ulist"><ul> -<li> -<p> -Several bug fixes for importing log files from other divelog software; - especially imports from DivingLog should work much better now, but - also new importer functions for UDDF and UDCF -</p> -</li> -<li> -<p> -Fixes for SAC calculation and gas volume estimates at high pressures - (air and nitrox are NOT ideal gases in the physics sense) -</p> -</li> -<li> -<p> -Added Help link to the online user manual -</p> -</li> -<li> -<p> -Improved the user manual -</p> -</li> -<li> -<p> -random other bug fixes -</p> -</li> -</ul></div> -</div> -<div class="sect2"> -<h3 id="_new_in_version_3_0_compared_to_em_subsurface_em_2_1">New in version 3.0 (compared to <em>Subsurface</em> 2.1):</h3> -<div class="ulist"><ul> -<li> -<p> -Many new divecomputers supported, bugfixes for existing divecomputers -</p> -</li> -<li> -<p> -Cressi Leonardo, Seemann XP5, Mares Matrix, Mares Puck Pro, Mares - Nemo Wide 2, Shearwater Petrel, Shearwater Predator, Aeris A300 - AI, Hollis DG03 -</p> -</li> -<li> -<p> -significant improvements for the Heinrichs Weiskamp OSTC -</p> -</li> -<li> -<p> -Significantly improved selection of divecomputers for direct download -</p> -</li> -<li> -<p> -Map display of GPS locations of dives and ability to enter and edit those -</p> -</li> -<li> -<p> -Improved automatic dive numbering -</p> -</li> -<li> -<p> -Data overlay for profile plot (with additional statistics information) -</p> -</li> -<li> -<p> -Zoom function for profile plot -</p> -</li> -<li> -<p> -Dive planner -</p> -</li> -<li> -<p> -Improved printing support -</p> -</li> -<li> -<p> -Improved dive trip handling -</p> -</li> -<li> -<p> -Support for downloading dives from multiple computers (so for example - both your main and your backup computer) -</p> -</li> -<li> -<p> -Added ability to import existing divelogs from Suunto DM3 (no manual - unpacking needed anymore), MacDive and divelogs.de -</p> -</li> -<li> -<p> -Lots of features to make tec divers happy: -</p> -</li> -<li> -<p> -Experimental deco calculation with optional display of a calculated - ceiling (Buhlmann ZH16 with gradient factors) -</p> -</li> -<li> -<p> -Display of deco information from some divecomputers that support this -</p> -</li> -<li> -<p> -TriMix support -</p> -</li> -<li> -<p> -CCR support (fixed or variable setpoint, on dive computers that support - this) -</p> -</li> -<li> -<p> -Optional pO₂, pN₂ and pHe graphs -</p> -</li> -<li> -<p> -CNS tracking for supported divecomputers -</p> -</li> -<li> -<p> -Lots of bug fixes -</p> -</li> -</ul></div> -</div> -</div> -</div> -</div> -<div id="footnotes"><hr /></div> -<div id="footer"> -<div id="footer-text"> -Last updated 2014-12-17 20:47:15 SAST -</div> -</div> -</body> -</html> diff --git a/ReleaseNotes/ReleaseNotes.txt b/ReleaseNotes/ReleaseNotes.txt index b3202da76..aa1dab670 100644 --- a/ReleaseNotes/ReleaseNotes.txt +++ b/ReleaseNotes/ReleaseNotes.txt @@ -1,16 +1,25 @@ -// _Subsurface_ 4.3 Release Notes +// _Subsurface_ 4.4 Release Notes -_Subsurface_ 4.3 - released December 2014 +_Subsurface_ 4.4 - released sometime early 2015 --------------------------------------- The _Subsurface_ development team proudly announces -release 4.3 of _Subsurface_, an open source divelog and dive planning -program for Windows, Mac and Linux. +the release of version 4.4 Beta 1 of _Subsurface_, an open source divelog +and dive planning program for Windows, Mac and Linux. License: GPLv2 _Subsurface_ can be found at: http://_Subsurface_-divelog.org +Some of the changes since _Subsurface_ 4.3 +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +We have added more capabilities to the CSV import for manually kept dive +logs; this now includes start and end pressure for the main tank as well +as air and water temperatures. + +Subsurface can now import dive databases from the Cobalt divelog program. + Some of the changes since _Subsurface_ 4.2 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |