diff options
Diffstat (limited to 'Documentation/user-manual.html.git')
| -rw-r--r-- | Documentation/user-manual.html.git | 292 |
1 files changed, 144 insertions, 148 deletions
diff --git a/Documentation/user-manual.html.git b/Documentation/user-manual.html.git index def10e821..b81684a7f 100644 --- a/Documentation/user-manual.html.git +++ b/Documentation/user-manual.html.git @@ -443,8 +443,9 @@ asciidoc.install(3); </div> <div class="paragraph"><p><span class="big">USER MANUAL</span></p></div> <div class="paragraph"><p><strong>Manual authors</strong>: Willem Ferguson, Jacco van Koll, Dirk Hohndel, Reinout Hoornweg, -Linus Torvalds, Miika Turkia, Amit Chaudhuri, Jan Schubert, Salvador Cuñat, Pedro Neves</p></div> -<div class="paragraph"><p><span class="blue"><em>Version 4.6, January 2017</em></span></p></div> +Linus Torvalds, Miika Turkia, Amit Chaudhuri, Jan Schubert, Salvador Cuñat, Pedro Neves, +Stefan Fuchs</p></div> +<div class="paragraph"><p><span class="blue"><em>Version 4.6, March 2017</em></span></p></div> <div class="paragraph"><p>Welcome as a user of <em>Subsurface</em>, an advanced dive logging program with extensive infrastructure to describe, organize, interpret and print scuba and free dives. <em>Subsurface</em> offers many advantages over other similar @@ -503,13 +504,14 @@ Do you wish to access or modify your dive log using a mobile phone? </p> </li> </ul></div> -<div class="paragraph"><p><em>Subsurface</em> binaries are available for Windows PCs (Win XP or later), Intel -based Macs (OS/X) and many Linux distributions. <em>Subsurface</em> can be built for +<div class="paragraph"><p><em>Subsurface</em> binaries are available for Windows PCs (Win 7 or later from +version 4.6 of <em>Subsurface</em> onwards), Intel based Macs (OS/X) and many +Linux distributions. <em>Subsurface</em> can be built for many more hardware platforms and software environments where Qt and libdivecomputer are available.</p></div> <div class="paragraph"><p>This manual explains how to use the <em>Subsurface</em> program. To install the software, consult the <em>Downloads</em> page on the -<a href="http://subsurface-divelog.org/"><em>Subsurface</em> web site</a>. +<a href="https://subsurface-divelog.org/"><em>Subsurface</em> web site</a>. Please discuss issues with this program by sending an email to <a href="mailto:subsurface@subsurface-divelog.org">our mailing list</a> and report bugs at <a href="https://github.com/Subsurface-divelog/subsurface/issues">our bugtracker</a>. For instructions on how to build the @@ -584,7 +586,7 @@ another survey, just launch <em>Subsurface</em> with the <em>--survey</em> optio <h2 id="S_StartUsing">3. Start Using the Program</h2> <div class="sectionbody"> <div class="paragraph"><p>The <em>Subsurface</em> window is usually divided into four panels with a <strong>Main -Menu</strong> (File Import Log View Help) at the top of the window (for Windows +Menu</strong> (File Edit Import Log View Share Help) at the top of the window (for Windows and Linux) or the top of the screen (for Mac and Ubuntu Unity). The four panels are:</p></div> <div class="olist arabic"><ol class="arabic"> <li> @@ -642,10 +644,9 @@ temperatures and SAC; total time and number of dives selected).</p></div> all highlighted dives.</p></div> <div class="paragraph"><p><strong>Globe</strong>: Show only the world map, centered on the last selected dive.</p></div> <div class="paragraph"><p>Like other functions that can be accessed via the Main Menu, these options -can also be triggered using keyboard shortcuts. The shortcuts for a particular system -are shown with an underline in the main menu entries. Since different Operating -Systems and the user’s chosen language may cause <em>Subsurface</em> to use different -shortcut keys, they are not listed in this user manual.</p></div> +can also be triggered using keyboard shortcuts. The shortcuts +are shown with an underline in the main menu entries, with the Alt-key pressed, +or are denoted after the menu item.</p></div> <div class="paragraph"><p>When the program is started for the first time, it shows no information at all, because it does not have any dive information available. In the following sections, the procedures to create a new logbook will be explained.</p></div> @@ -711,7 +712,7 @@ Spreadsheet or CSV files containing dive profiles. <div class="paragraph"><p>This is usually the approach for dives without a dive computer. The basic record of information within <em>Subsurface</em> is a dive. The most important information in a simple dive logbook usually includes dive type, date, time, duration, -depth, the names of your dive buddy and the dive master or dive guide, and +depth, the names of your dive buddy and the divemaster or dive guide, and some remarks about the dive. <em>Subsurface</em> can store much more information for each dive. To add a dive to a dive log, select <em>Log → Add Dive</em> from the Main Menu. The program then shows three panels @@ -763,7 +764,8 @@ line segments demarcated by waypoints (white dots on the profile, as shown above). The default dive depth is 15 m. If the dive depth was 20 m then you need to drag the appropriate waypoints downward to 20 m. To add a waypoint, double-click on -any line segment. To move an additional waypoint, drag it. +any line segment. To move an additional waypoint, drag it. Moving can also +be done by selecting the waypoint and using the arrow keys. To remove a waypoint, right-click on it and choose "Remove this point" from the context menu. Drag the waypoints to represent an accurate @@ -780,7 +782,7 @@ mixture specified in the <strong>Equipment</strong> tab, which was air in the ca profile above. The gas mixtures of segments of the dive profile can be changed by right-clicking on the particular waypoint and selecting the appropriate gas from the context menu. Changing -the gas for a waypoint affects the gas shown in the segment <em>to the left</em> of +the gas for a waypoint affects the gas shown in the segment <em>to the right</em> of that waypoint. Note that only the gases defined in the <strong>Equipment</strong> tab appear in the context menu (see image below).</p></div> @@ -806,7 +808,7 @@ each dive, e.g. a detailed record of depth, duration, rates of ascent/descent and of gas partial pressures. <em>Subsurface</em> can capture this information, using dive details from a wide range of dive computers. The latest list of supported dive computers can be found at: -<a href="http://subsurface-divelog.org/documentation/supported-dive-computers/"> +<a href="https://subsurface-divelog.org/documentation/supported-dive-computers/"> Supported dive computers</a>.</p></div> <div class="admonitionblock"> <table><tr> @@ -868,7 +870,7 @@ In <em>Subsurface</em>, from the Main Menu, select <em>Import → Import <div class="paragraph"><p>Dive computers tend to keep a certain number of dives in memory, even though these dives have already been imported to <em>Subsurface</em>. For that reason, if the dive computer allows this, -<em>Subsurface</em> only imports dives that have not been uploaded before. This makes +<em>Subsurface</em> only imports dives that have not been downloaded before. This makes the download process faster on most dive computers and also saves battery power of the dive computer (at least for those not charging while connected via USB).</p></div> <div class="ulist"><ul> @@ -1247,7 +1249,7 @@ visible (left hand image, below):</p></div> </div> </div> <div class="paragraph"><p>The right hand image, above, shows a <strong>Notes tab</strong> filled with dive information. -The <strong>Time</strong> field reflects the date and time of the dive. By clicking +The <strong>Date</strong> and <strong>Time</strong> fields reflects the date and time of the dive. By clicking the date, a calendar is displayed for selecting the correct date. Press ESC to close the calendar. The time values (hour and minutes) can also be @@ -1282,8 +1284,7 @@ made at the same location, the site information for the first dive is re-used. Existing dive locations can be edited by selecting (on the <strong>Dive List</strong> panel) a dive done at that site and by opening the location information. Click the globe button on the -right of the location name (see image on the right, above). When entering a dive location name, auto location of -dive site names makes it easy to select an existing dive site name. +right of the location name (see image image <strong>A</strong> below). When typing the name of a dive site, a dropdown list appears showing all sites with similar names. If the dive site has been used before, click on the already-existing name. @@ -1298,7 +1299,7 @@ dive site has not been used before, a message appears as follows (image <strong> <img src="images/Locations1_f22.jpg" alt="FIGURE:Location description panel" /> </div> </div> -<div class="paragraph"><p>Doubleclick on the new dive site name. A panel appears to enter the coordinates and +<div class="paragraph"><p>Click the globe button and a panel appears to enter the coordinates and other information about the site (image <strong>B</strong>, above). The most important items are the coordinates of the site. There are three ways to specify coordinates:</p></div> <div class="olist loweralpha"><ol class="loweralpha"> @@ -1364,7 +1365,7 @@ Freedive (dive without SCUBA equipment), CCR (Closed-circuit rebreather) and pSCR (Passive semi-closed rebreather).</p></div> <div class="paragraph"><p><strong>Divemaster</strong>: The name of the divemaster or dive guide should be entered in this field -which offers auto selection based on the list of dive masters in +which offers auto selection based on the list of divemasters in the current logbook.</p></div> <div class="paragraph"><p><strong>Buddy</strong>: In this field, enter the name(s) of the buddy or buddies (separated with commas) who were on the @@ -1488,7 +1489,7 @@ with two types of weights: integrated as well as a weight belt:</p></div> </div> <div class="sect3"> <h4 id="_editing_several_selected_dives_simultaneously">5.2.6. Editing several selected dives simultaneously</h4> -<div class="paragraph"><p><em>METHOD 1</em>: After uploading dives from +<div class="paragraph"><p><em>METHOD 1</em>: After downloading dives from a dive computer, the dive profiles of each is shown in the <strong>Dive profile</strong> tab, as well as a few items of information in the <strong>Notes</strong> tab (e.g. water temperature) and in the <strong>Equipment</strong> tab (e.g. gas pressures @@ -1591,7 +1592,9 @@ from there with <em>Subsurface</em>. Divelogs.de supports a few additional logbook formats that <em>Subsurface</em> currently cannot handle.</p></div> <div class="paragraph"><p>If the format of other software is supported natively on Subsurface, select -either <em>Import → Import log files</em> or <em>File → Open log file</em>. <em>Subsurface</em> supports the data formats +either <em>Import → Import log files</em> or <em>File → Open log file</em>. Notice that +the import adds the imported data to the current <strong>Dive list</strong>, and the open style +starts a new dive list. <em>Subsurface</em> supports the data formats of many dive computers, including Suunto, Shearwater and some CCR equipment. When importing dives, <em>Subsurface</em> tries to detect multiple records for the same dive and merges the information as best as it can. If @@ -1680,6 +1683,16 @@ Underwater technologies AV1 dive logs </li> <li> <p> +Divesoft dive logs +</p> +</li> +<li> +<p> +Poseidon MK VI eCCR dive logs +</p> +</li> +<li> +<p> CSV (text-based and spreadsheet-based) dive logs, including APD CCR logs </p> </li> @@ -1982,7 +1995,7 @@ be used to import information from other sources like spreadsheet-based dive log some dive computers.</td> </tr></table> </div> -<div class="paragraph"><p><em>CSV</em> files can be created or edited with a normal text editor. The most important attribute of a +<div class="paragraph"><p>The most important attribute of a <em>CSV</em> file is the <em>field separator</em>, the character used to separate fields within a single line. The field separator is frequently a comma, a colon, a SPACE character or a TAB character. When exporting data from spreadsheet software, the field separator needs to be specified in order to create the <em>CSV</em> file. <em>CSV</em> files are @@ -2016,7 +2029,7 @@ cannot be maintained. Here is a highly simplified and shortened TAB-delimited ex from an APD closed-circuit rebreather (CCR) dive computer:</p></div> <div class="literalblock"> <div class="content"> -<pre><code>Dive Time (s) Depth (m) pO₂ - Setpoint (Bar) pO₂ - C1 Cell 1 (Bar) Ambient temp. (Celsius) +<pre><code>Dive Time (s) Depth (m) pO~2~ - Setpoint (Bar) pO~2~ - C1 Cell 1 (Bar) Ambient temp. (Celsius) 0 0.0 0.70 0.81 13.1 0 1.2 0.70 0.71 13.1 0 0.0 0.70 0.71 13.1 @@ -2157,8 +2170,7 @@ via a wifi connection. If the Internet is not accessible from the dive site(s), then GPS uploading can only take place after the dive or after the dive trip, when an Internet connection has been re-established.</p></div> <div class="paragraph"><p>From the <em>Subsurface-mobile</em> main menu, select <em>GPS</em> → <em>Upload GPS data</em>. The -locations are uploaded. Check the indicator at the top of the mobile screen for -internet activity, indicating the transfer of information.</p></div> +locations are uploaded.</p></div> </div> <div class="sect4"> <h5 id="_apply_the_stored_gps_locations_to_dives_on_the_em_subsurface_em_dive_list">Apply the stored GPS locations to dives on the <em>Subsurface</em> dive list.</h5> @@ -2199,7 +2211,7 @@ Register on the <a href="http://api.hohndel.org/login/"><em>Subsurface companion Download the app from <a href="https://play.google.com/store/apps/details?id=org.subsurface">Google Play Store</a> or from - <a href="http://f-droid.org/repository/browse/?fdfilter=subsurface&fdid=org.subsurface">F-Droid</a>. + <a href="https://f-droid.org/repository/browse/?fdfilter=subsurface&fdid=org.subsurface">F-Droid</a>. </p> </li> </ul></div> @@ -2238,7 +2250,7 @@ Download the app from </td> <td class="content">In the <em>Subsurface</em> main program, the <strong>DIVERID</strong> should also be entered on the Default Preferences -panel, by selecting <em>File → Preferences → Defaults</em> from the main menu +panel, by selecting <em>File → Preferences → General</em> from the main menu in <em>Subsurface</em> itself. This helps synchronization between <em>Subsurface</em> and the Companion App.</td> </tr></table> @@ -2279,12 +2291,12 @@ Use Map: This option allows you to fix a position by searching a world map. A <p> Import local GPX file: The Android device searches for .gpx files and located archives will be shown. The selected .gpx file is opened and its - locations shown. Now select the appropriate locations, then select the - tab in the upper right, afterAndroid device. + locations shown. Now select the appropriate locations, and select the check + symbol in the upper right to add them. </p> </li> </ul></div> -<div class="paragraph"><p><strong>Dive lists of dive locations</strong></p></div> +<div class="paragraph"><p><strong>List of dive locations</strong></p></div> <div class="paragraph"><p>The main screen shows a list of dive locations, each with a name, date and time (see <strong>A</strong> below). Some locations may have an arrow-up icon over the selection box to the left showing they need to be uploaded to the server. You @@ -2309,7 +2321,7 @@ of the screen:</p></div> <div class="ulist"><ul> <li> <p> -Edit (pencil): Change the text name or other characteristics of the dive location. +Edit (pencil): Change the name of the dive location. </p> </li> <li> @@ -2537,8 +2549,8 @@ superimposed on the dive profile at the times during the dive when they were tak from the dive profile.</p></div> <div class="sect3"> <h4 id="_loading_photos_and_synchronizing_between_dive_computer_and_camera">5.5.1. Loading photos and synchronizing between dive computer and camera</h4> -<div class="paragraph"><p>Left-lick on a dive or on a group of dives on the dive list, bringing up the <a href="#S_DiveListContextMenu">Dive list context Menu</a>. Right-click the appropriate -option to import images either from +<div class="paragraph"><p>Right-click on a dive or on a group of dives on the dive list, bringing up the <a href="#S_DiveListContextMenu">Dive list context Menu</a>. +Select the appropriate option to import images either from file or from the Internet. The system file browser appears. Select the folder and photographs that need to be loaded into <em>Subsurface</em> and click the <em>Open</em> button.</p></div> <div class="imageblock" style="text-align:center;"> @@ -2551,7 +2563,7 @@ If the URL points to a directory, no images are imported: photos from the Intern need to be imported one at a time. If photos are loaded from the Internet, <em>Subsurface</em> assumes there is an Internet connection each time this photo is viewed within <em>Subsurface</em>.</p></div> -<div class="paragraph"><p>Having selected the local folder ot Internet image to be imported, the time synchronization dialog appears (see image below). The time +<div class="paragraph"><p>Having selected the local folder or Internet image to be imported, the time synchronization dialog appears (see image below). The time synchronization is not perfect between the dive computer used during a dive and the camera used during that same dive. These two devices often differ by several minutes. <em>Subsurface</em> attempts to synchronize these two devices @@ -2852,7 +2864,7 @@ dive logging involves three steps, exactly as with multi-cylinder dives above:</ </div> </div> <div class="sect3"> -<h4 id="S_sSCR_dives">5.6.3. Semi-closed circuit rebreather (SCR) dives</h4> +<h4 id="S_sSCR_dives">5.6.3. Passive semi-closed circuit rebreather (pSCR) dives</h4> <div class="admonitionblock"> <table><tr> <td class="icon"> @@ -2861,11 +2873,11 @@ dive logging involves three steps, exactly as with multi-cylinder dives above:</ <td class="content">Passive semi-closed rebreathers (pSCR) are a technical advance in diving equipment that recirculates the breathing gas a diver uses, while removing carbon dioxide from the exhaled gas. While a small amount (typically a tenth) of the exhaled breathing gas is released into the water, -a small amount of fresh gas is released from the back gas cylinder (typically containing nitrox). +a small amount of fresh gas is released from the driving gas cylinder. A diver using a single cylinder of breathing gas can therefore dive for much longer periods than using a recreational open-circuit configuration. With pSCR equipment, a very small amount of breathing gas is released every time the diver inhales. With active SCR (aSCR) equipment, in contrast, a small amount of -breathing gas is released continuously from the back cylinder.</td> +breathing gas is released continuously from the driving cylinder.</td> </tr></table> </div> <div class="paragraph"><p>To log pSCR dives, no special procedures are required. Use the normal steps outlined above:</p></div> @@ -2885,7 +2897,7 @@ pSCR diving often involves gas changes, requiring an additional cylinder. </ul></div> <div class="paragraph"><p>If a pSCR <em>Dive Mode</em> has been selected, the dive ceiling for that is adjusted for the oxygen drop across the mouthpiece, which often requires longer decompression periods. Below is a dive profile -of a pSCR dive using EAN36 on the back cylinder and oxygen for decompression. Note that this dive lasted +of a pSCR dive using EAN36 as bottom gas and oxygen for decompression. Note that this dive lasted over two hours.</p></div> <div class="imageblock" style="text-align:center;"> <div class="content"> @@ -2966,7 +2978,7 @@ If no sensor data are available, the pO<sub>2</sub> value is assumed to be equal <div class="paragraph"><p>The oxygen setpoint values as well as the readings from the individual oxygen sensors can be shown. The display of additional CCR information is turned on by checking the appropriate boxes in the <em>Preferences</em> panel (accessible by -selecting <a href="#S_CCR_options"><em>File → Preferences → Graph</em></a>). This part of +selecting <a href="#S_CCR_options"><em>File → Preferences → Profile</em></a>). This part of the <em>Preferences</em> panel is shown in the image below, representing two checkboxes that modify the display of pO<sub>2</sub> when the appropriate toolbar button on the Dive Profile has been checked.</p></div> @@ -2982,7 +2994,7 @@ superimposed on the green oxygen partial pressure graph and allows a comparison mean measured oxygen partial pressure and the setpoint values, as shown below.</p></div> <div class="imageblock" style="text-align:center;"> <div class="content"> -<img src="images/CCR_setpoint_f20.jpg" alt="FIGURE: CCR setpoint and po2 graph" /> +<img src="images/CCR_setpoint_f20.jpg" alt="FIGURE: CCR setpoint and pO~2~ graph" /> </div> </div> <div class="paragraph"><p>The second checkbox allows the display of the data from each individual oxygen sensor @@ -3044,7 +3056,7 @@ by clicking the appropriate button to the left of the dive profile:</p></div> </div> </div> <div class="paragraph"><p>The default color of the computer-generated deco ceiling is white. This can be set to red -by checking the appropriate check box after selecting <em>File → Preferences → Graph</em>. +by checking the appropriate check box after selecting <em>File → Preferences → Profile</em>. Below is a dive profile indicating the dive computer-generated deco ceiling:</p></div> <div class="imageblock" style="text-align:center;"> <div class="content"> @@ -3183,9 +3195,7 @@ placed adjacent to significant changes.</p></div> <h4 id="S_InfoBox">6.4.1. The <strong>Information Box</strong></h4> <div class="paragraph"><p>The Information box displays a large range of information about the dive profile. Normally the Information Box is located to the top left of the <strong>Dive -Profile</strong> panel. If the mouse points outside of the <strong>Dive Profile</strong> panel, then -only the top line of the Information Box is visible (see left-hand part of -figure (<strong>A</strong>) below). The Information Box can be moved around in the <strong>Dive Profile</strong> +Profile</strong> panel. The Information Box can be moved around in the <strong>Dive Profile</strong> panel by click-dragging it with the mouse so that it is not obstructing important detail. The position of the Information Box is saved and used again during subsequent dive analyses.</p></div> @@ -3216,7 +3226,7 @@ buttons on the left of the profile panel. These are:</p></div> <td class="content">Show the <strong>Maximum Operating Depth (MOD)</strong> of the dive, given the gas mixture used. MOD is dependent on the oxygen concentration in the breathing gas. For air (21% oxygen) it is around 57 m if a maximum pO<sub>2</sub> of 1.4 is specified in the <strong>Preferences</strong> section -(select <em>File → Preferences → Graph</em> and edit the text box <em>pO<sub>2</sub> in calculating MOD</em>. +(select <em>File → Preferences → Profile</em> and edit the text box <em>pO<sub>2</sub> in calculating MOD</em>. When diving below the MOD there is a markedly increased risk of exposure to the dangers of oxygen toxicity.</td> </tr></table> </div> @@ -3231,8 +3241,7 @@ dive, given the present depth, that does not require decompression (that is, bef ascent ceiling appears). Once a diver has exceeded the NDL and decompression is required (that is, there is an ascent ceiling above the diver) then TTS gives the number of minutes required before the diver can surface. TTS includes ascent time as well as decompression -time. TTS is calculated assuming an ascent surface air consumption (SAC) for -the gas currently used. Even if the profile contains several gas +time. Even if the profile contains several gas switches, TTS at a specific moment during the dive is calculated using the current gas. TTS longer than 2 hours is not accurately calculated and Subsurface only indicates <em>TTS > 2h</em>.</td> </tr></table> @@ -3313,7 +3322,7 @@ The dark green area at the bottom of the graph represents the pressures of inert The top black horizontal line indicates the inert gas pressure limit determined by the gradient factor that applies to the depth of the diver at the particular point on the <strong>Dive Profile</strong>. The gradient factor shown is an - interpolation between the GFLow and GFHigh values specified in the <em>Graph</em> tab of the <strong>Preferences + interpolation between the GFLow and GFHigh values specified in the <em>Profile</em> tab of the <strong>Preferences Panel</strong> of <em>Subsurface</em>. </p> </li> @@ -3818,21 +3827,15 @@ trips by clicking the expansion button [+/-] on the left of each trip title. Thi the selected trip, revealing individual dives during the trip.</p></div> </div> <div class="sect3"> -<h4 id="_collapsing_or_expanding_dive_information_for_different_trips">7.3.3. Collapsing or expanding dive information for different trips</h4> -<div class="paragraph"><p>After selecting a particular trip in the dive list, the -context menu allows several options to expand or collapse dives -within trips. This includes expanding all trips and collapsing all trips.</p></div> -</div> -<div class="sect3"> -<h4 id="_merging_dives_from_more_than_one_trip_into_a_single_trip">7.3.4. Merging dives from more than one trip into a single trip</h4> +<h4 id="_merging_dives_from_more_than_one_trip_into_a_single_trip">7.3.3. Merging dives from more than one trip into a single trip</h4> <div class="paragraph"><p>After selecting a trip title, the context menu allows the merging of trips by either merging the selected trip with the trip below or with the trip above. (Merge trip with trip below; Merge trip with trip above)</p></div> </div> <div class="sect3"> -<h4 id="_splitting_a_single_trip_into_more_than_one_trip">7.3.5. Splitting a single trip into more than one trip</h4> -<div class="paragraph"><p>If a trip includes ten dives, you can split this trip into two trips (trip 1: -top 4 dives; trip 2: bottom 6 dives) by selecting and right-clicking the top +<h4 id="_splitting_a_single_trip_into_more_than_one_trip">7.3.4. Splitting a single trip into more than one trip</h4> +<div class="paragraph"><p>If a trip includes, for example, ten dives, you can split this trip into two trips (trip 1: +top four dives; trip 2: bottom six dives) by selecting and right-clicking the top four dives. The resulting context menu lets the user create a new trip by choosing the option <strong>Create new trip above</strong>. The top four dives are then grouped @@ -3926,7 +3929,7 @@ To do this after performing any of these actions, from the <strong>Main Menu</st <div class="sect2"> <h3 id="S_Filter">7.5. Filtering the dive list</h3> <div class="paragraph"><p>The dives in the <strong>Dive List</strong> panel can be filtered, selecting only some -of the dives based on their attributes, e.g. dive tags, dive site, dive master, buddy or protective +of the dives based on their attributes, e.g. dive tags, dive site, divemaster, buddy or protective clothing. For instance, filtering lets you list the deep dives at a particular dive site, or otherwise the cave dives with a particular buddy.</p></div> <div class="paragraph"><p>To open the filter, select <em>Log → Filter divelist</em> from the main menu. This opens the @@ -3992,7 +3995,7 @@ Close this message panel.</p></div> </div> </div> <div class="paragraph"><p>Having established a login to <em>Facebook</em>, transferring a dive profile to a <em>Facebook</em> timeline is easy. -In the <em>Subsurface</em> <strong>Dive Profile</strong> panel, highlight the dive to be transferred. +In the <em>Subsurface</em> <strong>Dive List</strong> panel, highlight the dive to be transferred. Then, from the <strong>Main Menu</strong>, select <em>Share on → Facebook</em>. A dialogue box is shown, determining the amount of additional information to be transferred with the dive profile (image <strong>A</strong>, below). To transfer a dive profile to <em>Facebook</em>, the name of a @@ -4268,7 +4271,7 @@ don’t need the web access), it’s simple to store dive logs in the cloud using several of the existing facilities on the Internet. For instance -<a href="http://www.dropbox.com/"><em>Dropbox</em></a> +<a href="https://www.dropbox.com/"><em>Dropbox</em></a> offers a free application that allows files on the Dropbox servers to be seen as a local folder on a desktop computer.</p></div> <div class="imageblock" style="text-align:center;"> @@ -4283,20 +4286,6 @@ using the local copy of the dive log in the local <em>Dropbox</em> folder, so th for a direct internet connection. If the local copy is modified, e.g. by adding a dive, the remote copy in the <em>Dropbox</em> server in the Cloud will be automatically updated whenever Internet access is available.</p></div> -<div class="paragraph"><p>In this way a dive log in -your <em>Dropbox</em> folder can be accessed seamlessly from the Internet and can -be accessed anywhere with Internet access. Currently there are no costs -involved for this service. Dropbox (Windows, Mac -and Linux) can be installed by accessing the -<a href="http://www.dropbox.com/install"><em>Install Page on the Dropbox website</em></a> -. Alternatively you can use <em>Dropbox</em> as a way back up your dive log. To -Store a dive log on <em>Dropbox</em>, select <em>File → Save as</em> from the <em>Subsurface</em> main menu, -navigate to the <em>Dropbox</em> folder and select the <em>Save</em> button. To access the dive log -in <em>Dropbox</em>, select <em>File → Open Logbook</em> from the <em>Subsurface</em> -main menu and navigate to the dive log file in the <em>Dropbox</em> folder and select the -<em>Open</em> button.</p></div> -<div class="paragraph"><p>Several paid services exist on the Internet (e.g. Google, Amazon) where the same -process could be used for the Cloud-based storage of dive logs.</p></div> </div> </div> </div> @@ -4491,7 +4480,7 @@ to write or modify a template.</p></div> <div class="sect1"> <h2 id="S_Configure">12. Configuring a dive computer</h2> <div class="sectionbody"> -<div class="paragraph"><p><em>Subsurface</em> lets you configure a dive computer. Currently the Heinrichs-Weikamp (OSTC 2, OSTC 3) and +<div class="paragraph"><p><em>Subsurface</em> lets you configure a dive computer. Currently, the Heinrichs-Weikamp (OSTC 2/2N/2C, OSTC 3, Sport) and Suunto Vyper (Stinger, Mosquito, D3, Vyper, Vytec, Cobra, Gekko and Zoop) family of dive computers are supported. A large number of settings of these dive computers can be read and changed to different values. To begin, be sure the appropriate hardware driver @@ -4548,18 +4537,18 @@ computer model from the panel on the left-hand (see image below).</p></div> <div class="paragraph"><p>There are several user-definable settings within <em>Subsurface</em>, found by selecting <em>File → Preferences</em>, mostly affecting the way in which <em>Subsurface</em> shows dive information to the user. The settings are in -six panels: <em>Defaults</em>, <em>Units</em>, <em>Graph</em>, <em>Language</em>, <em>Network</em>, and <em>Georeference</em>, +six panels: <em>General</em>, <em>Units</em>, <em>Profile</em>, <em>Language</em>, <em>Network</em>, and <em>Georeference</em>, all of which operate on the same principles: specified settings can be applied to the display of the dive log by selecting <em>Apply</em>. At this stage, any new settings only apply to the present session and are not saved. In order to apply new settings permanently, select the <em>Save</em> button. If you do not wish to apply the new preferences, select <em>Cancel</em>.</p></div> <div class="sect2"> -<h3 id="_defaults">13.1. Defaults</h3> -<div class="paragraph"><p>There are several headings in the <strong>Defaults</strong> panel:</p></div> +<h3 id="_general">13.1. General</h3> +<div class="paragraph"><p>There are several headings in the <strong>General</strong> panel:</p></div> <div class="imageblock" style="text-align:center;"> <div class="content"> -<img src="images/Pref1_f23.jpg" alt="FIGURE: Preferences defaults page" /> +<img src="images/Pref1_f23.jpg" alt="FIGURE: Preferences general page" /> </div> </div> <div class="ulist"><ul> @@ -4647,7 +4636,7 @@ traditional coordinates (degrees, minutes, seconds) or as decimal degrees Choose the appropriate option.</p></div> </div> <div class="sect2"> -<h3 id="_graph">13.3. Graph</h3> +<h3 id="_profile">13.3. Profile</h3> <div class="paragraph"><p>This panel has three sections:</p></div> <div class="imageblock" id="S_CCR_options" style="text-align:center;"> <div class="content"> @@ -4692,7 +4681,7 @@ CCR Options: These options determine oxygen management for CCR dives: </li> <li> <p> -<em>CCR: Show setpoints when viewing pO2:</em> With this checkbox activated, the pO<sub>2</sub> +<em>CCR: Show setpoints when viewing pO<sub>2</sub>:</em> With this checkbox activated, the pO<sub>2</sub> graph on the dive profile has an overlay in red which indicates the CCR setpoint values. See the section on <a href="#S_CCR_dives">Closed Circuit Rebreather dives</a>. </p> @@ -4738,7 +4727,7 @@ CCR Options: These options determine oxygen management for CCR dives: </li> <li> <p> -Bühlmann: Set the <em>gradient factors</em> (GFlow and GFHigh) for calculcating the deco ceiling following +Bühlmann: Set the <em>gradient factors</em> (GFLow and GFHigh) for calculcating the deco ceiling following the ZH-L16 algorithm. GF_Low is the gradient factor at depth and GF_High is used at the surface. At intermediate depths gradient factors between GF_Low and GF_High are used. Gradient factors add conservatism to nitrogen and helium exposure during a dive, in a @@ -4747,7 +4736,7 @@ Bühlmann: Set the <em>gradient factors</em> (GFlow and GFHigh) for calculcating respect to inert gas loading and the deeper the ceilings are. Gradient factors of 20/60 are considered conservative and values of 70/90 are considered harsh. - In addition decide whether to check the <em>GFLow at max depth</em> box. If checked, GF_Low is used for the + In addition decide whether to check the <em>GFLow at max. depth</em> box. If checked, GF_Low is used for the deepest dive depth and linearly increased up to the GF_High value at the surface. If unchecked, GF_Low is used between the deepest dive depth and the first deco stop, after which the gradient factor linearly increases up to the GF_High value at the surface. For more information see: @@ -4826,15 +4815,13 @@ combination from the list of locations. The <em>Filter</em> text box to list similar languages. For instance there are several system variants of English or French. <strong>This particular preference requires a restart of <em>Subsurface</em> to take effect</strong>.</p></div> -<div class="paragraph"><p>In this section also specify appropriate date an time formats for showing dive details.</p></div> +<div class="paragraph"><p>In this section also specify appropriate date and time formats for showing dive details.</p></div> </div> <div class="sect2"> <h3 id="_network">13.5. Network</h3> <div class="paragraph"><p>This panel facilitates communication between <em>Subsurface</em> and data sources on the Internet. This is important, for instance, when <em>Subsurface</em> needs to communicate with web -services such as Cloud storage or the <a href="#S_Companion"><em>Subsurface Companion app</em></a>. These Internet requirements are determined by your type of -connection to the Internet and by the Internet Service Provider (ISP) used. -Your ISP should provide the appropriate information.</p></div> +services such as Cloud storage, the <a href="#S_Companion"><em>Subsurface Companion app</em></a> or when you want to communicate through a proxy.</p></div> <div class="imageblock" style="text-align:center;"> <div class="content"> <img src="images/Pref5_f23.jpg" alt="FIGURE: Preferences Network page" /> @@ -4844,7 +4831,7 @@ Your ISP should provide the appropriate information.</p></div> <div class="ulist"><ul> <li> <p> -<em>Proxy type</em>: +<em>Proxy</em>: If a proxy server is used for Internet access, the type of proxy needs to be selected from the dropdown list, after which the IP address of the host and the appropriate port number should be provided. If the proxy server uses authentication, the appropriate userID and @@ -4906,7 +4893,7 @@ or <em>City/State/Country</em> (see image below).</p></div> <div class="paragraph"><p>Dive planning is an advanced feature of <em>Subsurface</em>, accessed by selecting <em>Log → Plan Dive</em> from the main menu. It allows calculation of inert gas load during a dive by using the Bühlmann ZH-L16 algorithm with the addition -of gradient factors as implemented by Erik Baker.</p></div> +of gradient factors as implemented by Erik Baker, or using the VPM-B model.</p></div> <div class="sidebarblock"> <div class="content"> <div class="admonitionblock"> @@ -4959,7 +4946,7 @@ A user who is not absolutely sure about any of the above requirements should not <div class="sect2"> <h3 id="_the_em_subsurface_em_dive_planner_screen">14.1. The <em>Subsurface</em> dive planner screen</h3> <div class="paragraph"><p>Like the <em>Subsurface</em> dive log, the planner screen is divided into several sections (see image below). The <strong>setup</strong> -parameters for a dive are entered into the sections on the left hand side of the screen. +parameters for a dive are entered into the sections on the left hand and bottom side of the screen. They are: Available Gases, Rates, Planning, Gas Options and Notes.</p></div> <div class="paragraph"><p>At the top right hand is a green <strong>design panel</strong> on which the profile of the dive can be manipulated directly by dragging and clicking as explained below. This feature makes the @@ -5016,8 +5003,8 @@ In the top left-hand area of the planning screen, be sure the constant dive para In the table labelled <em>Available Gases</em>, add the information of the cylinders to be used as well as the gas composition within that cylinder. This is done in a similar way as for <a href="#cylinder_definitions">providing cylinder data for dive logs</a>. Choose the cylinder type by - double clicking the cylinder type and using the dropdown list, then specify the work - pressure of this cylinder. By leaving the oxygen concentration (O2%) field empty, + double clicking the cylinder type and using the dropdown list, then specify the start + pressure of this cylinder. By leaving the oxygen concentration (O<sub>2</sub>%) field empty, the cylinder is assumed to contain air. Otherwise enter the oxygen and/or helium concentration in the boxes provided in this dialogue. Add additional cylinders by using the "+" icon to the top right-hand of the dialogue. @@ -5031,14 +5018,14 @@ The <em>Available Gases</em> table includes three gas depth fields, labelled: <li> <p> Deco switch at: the switch depth for deco gases. Unless overridden by the user, this will be - automatically calculated based on the Deco pO₂ preference (default 1.6 bar) + automatically calculated based on the Deco pO<sub>2</sub> preference (default 1.6 bar) </p> </li> <li> <p> Bot. MOD: the gas Maximum Operating Depth (MOD) if it is used as a bottom mix. Automatically - calculated based on the Bottom pO₂ preference (default 1.4 bar). Editing this field will modify the - O₂% according to the depth set. Set to <em>'*</em>' to calculate the best O₂% for the dive maximum depth. + calculated based on the Bottom pO<sub>2</sub> preference (default 1.4 bar). Editing this field will modify the + O<sub>2</sub>% according to the depth set. Set to <em>'*</em>' to calculate the best O<sub>2</sub>% for the dive maximum depth. </p> </li> <li> @@ -5069,7 +5056,7 @@ Drag the waypoints The most efficient way to create a dive profile is to enter the appropriate values into the table marked <em>Dive planner points</em>. The first line of the table represents the duration and the final depth of the descent from the surface. Subsequent segments describe the bottom phase of the dive. - The <em>CC set point</em> column is only relevant for closed circuit divers. + The <em>CC setpoint</em> column is only relevant for closed circuit divers. The ascent is usually not specified because this is what the planner is supposed to calculate. Add additional segments to the profile by selecting the "+" icon at the top right hand of the table. Segments entered into the <em>Dive planner points</em> table automatically appear in the <strong>Dive @@ -5112,7 +5099,7 @@ Immediately under the heading <em>Planning</em> are two checkboxes <em>Recreatio <li> <p> Then define the cylinder size, - the gas mixture (air or % oxygen) and the starting cylinder pressure in the top left-hand + the gas mixture (air or % oxygen) and the working cylinder pressure in the top left-hand section of the planner under <em>Available gases</em>. </p> </li> @@ -5166,7 +5153,7 @@ minutes, the duration of the dive is limited by the amount of air in the cylinde text box at the bottom right of the panel, requiring sufficient air for buddy-sharing during ascent.</p></div> <div class="imageblock" style="text-align:center;"> <div class="content"> -<img src="images/rec_diveplan.jpg" alt="FIGURE: A recreational dive plan: setup" /> +<img src="images/Planner_OC_rec.jpg" alt="FIGURE: A recreational dive plan: setup" /> </div> </div> </div> @@ -5177,7 +5164,7 @@ These dives are planned in three stages:</p></div> <div class="paragraph"><p><strong>a) Nitrogen management</strong>: This is done by specifying the rates for descent and ascent, as well as the deco model (GFLow, GFHigh or Conservatism level) under the headings <em>Rates</em> and <em>Planning</em> to the bottom left of the planning screen. Two deco models are supported the Bühlmann model and the VPM-B -model. Select one of the two models. When selecting the Bühlmann model, the gradient factors (GFhigh and GFlow +model. Select one of the two models. When selecting the Bühlmann model, the gradient factors (GFHigh and GFLow need to be specified. Initially, the GFHigh and GFLow values in the <em>Preferences</em> panel of <em>Subsurface</em> is used. If these are changed within the planner (see <em>Gas Options</em> within the planner), the new values are @@ -5204,7 +5191,7 @@ only mathematical models that appear to work in practice.</p></div> </li> <li> <p> -<a href="http://www.amazon.com/Deco-Divers-Decompression-Theory-Physiology/dp/1905492073/ref=sr_1_1?s=books&ie=UTF8&qid=1403932320&sr=1-1&keywords=deco+for+divers"><em>Deco for Divers</em>, by Mark Powell (2008). Aquapress</a> Southend-on-Sea, UK. ISBN 10: 1-905492-07-3. +<a href="https://www.amazon.com/Deco-Divers-Decompression-Theory-Physiology/dp/1905492073/ref=sr_1_1?s=books&ie=UTF8&qid=1403932320&sr=1-1&keywords=deco+for+divers"><em>Deco for Divers</em>, by Mark Powell (2008). Aquapress</a> Southend-on-Sea, UK. ISBN 10: 1-905492-07-3. An excellent non-technical review that discusses both the Bühlmann deco model and the VPM-B model. </p> </li> @@ -5220,8 +5207,9 @@ in the <em>Rates</em> section of the dive setup.</p></div> pressure for oxygen needs to be specified for the bottom part of the dive (<em>bottom po2</em>) as well as for the decompression part of the dive (<em>deco po2</em>). Commonly used values are 1.4 bar for the bottom part of the dive and 1.6 bar for any decompression -stages. Normally, a partial pressure of 1.6 bar is not exceeded. PO2 settings and the depth at which switching to a gas takes place can also be edited in the -<em>Available Gases</em> dialog. Normally the planner decides on switching to a new gas when, during +stages. Normally, a partial pressure of 1.6 bar is not exceeded. The depth at which switching to a gas +takes place can be edited in the +<em>Available Gases</em> dialog. Normally, the planner decides on switching to a new gas when, during ascent, the partial pressure of the new gas has decreased to 1.6 bar.</p></div> <div class="paragraph"><p><strong>c) Gas management</strong>: With open-circuit dives this is a primary consideration. Divers need to keep within the limits of the amount of @@ -5238,7 +5226,21 @@ The planner calculates the total volume of gas used during the dive and issues a if you exceeds the total amount of gas available. Good practice demands that divers not dive to the limit of the gas supply but that an appropriate reserve is kept for unforeseen circumstances. -For technical diving, this reserve can be up to 66% of the total available gas.</p></div> +For technical diving, this reserve can be up to 66% of the total available gas. +In addition to calculating the total gas consumption for every cylinder the planner provides one way +of calculating the recommended volume of bottom gas which is needed for safe asscent to the +first deco gas change depth or the surface. This procedure is called the "minimum gas" or "rock bottom" +consideration and it is used by various (but not all) +technical diving organisations. The calculation assumes that in worst case an out of gas (OoG) +situation could occur at the end of the planned bottom time at maximum depth. This OoG event forces +the buddy team the share the gas of one diver and to stay at maximum depth for an additional +time of n minutes (preferences option "problem solving time"). +At the same moment the combined SAC of both divers is increased by a estimated factor (preferences option +"SAC factor") compared to the SAC factor of a single diver under normal conditions. +The result of the minimum gas calculation for the bottom gas is printed to the planner output as an +additional information. No automatic checks are performed based on this result. +Please take care that the feature only gives valid results for simple, rectengular shaped single +level dive profiles. For multi level dives one would need to check every leg of the profile independently.</p></div> <div class="paragraph"><p>Now you can start the detailed time-depth planning of the dive. <em>Subsurface</em> offers an unique graphical interface for doing planning. The mechanics are similar to hand-entering a dive profile in the dive log part of <em>Subsurface</em>. Upon activating the @@ -5254,21 +5256,18 @@ above the dive profile changes from BLUE to RED.</p></div> left of the dive planner panel. Ensure the <em>Used Gas</em> value in each row of that table corresponds to one of the gas mixtures specified in the <em>Available Gases</em> table. Add new waypoints until the main features of the dive have been completed, e.g. the -bottom time segment and deep stops (if these are implemented). Leave the remaining -waypoints on the ascent to <em>Subsurface</em>. In most cases <em>Subsurface</em> +bottom time segment and deep stops (if these are implemented). In most cases <em>Subsurface</em> computes additional way points in order to fulfill decompression requirements for that -dive. A waypoint can be moved by selecting it and by using the arrow keys. +dive. A waypoint can also be moved by selecting it and by using the arrow keys. The waypoints listed in the <em>Dive Planner Points</em> dialogue can be edited by hand in order to get a precise presentation of the dive plan. In fact, it is sometimes more easy to create the whole dive profile by editing the <em>Dive Planner Points</em> dialog.</p></div> <div class="paragraph"><p>Show any changes in gas cylinder used by indicating gas changes as explained in the section <a href="#S_CreateProfile">hand-creating a dive profile</a>. These changes should reflect the cylinders and gas compositions defined in the table with <em>Available Gases</em>. -If two or more gases are used, automatic gas switches will be suggested during the ascent to -the surface. These changes can be deleted by right-clicking the gas change and -manually creating a gas change by right-clicking on the appropriate -waypoint.</p></div> -<div class="paragraph"><p>A non-zero value in the "CC set point" column of the table of dive planner points +If two or more gases are used, automatic gas switches will be planned during the ascent to +the surface.</p></div> +<div class="paragraph"><p>A non-zero value in the "CC setpoint" column of the table of dive planner points indicates a valid setpoint for oxygen partial pressure and that the segment is dived using a closed circuit rebreather (CCR). If the last manually entered segment is a CCR segment, the decompression phase is computed assuming the diver @@ -5276,11 +5275,11 @@ uses a CCR with the specified set-point. If the last segment (however short) is on open circuit (OC, indicated by a zero set-point) the decompression is computed in OC mode and the planner only considers gas changes in OC mode.</p></div> -<div class="paragraph"><p>Below is an example of a dive plan to 45m using EAN26, followed by an ascent using EAN50 -and using the settings as described above.</p></div> +<div class="paragraph"><p>Below is an example of a dive plan to 45m using Tx21/35, followed by an ascent using EAN50 +and oxygen and using the settings as described above.</p></div> <div class="imageblock" style="text-align:center;"> <div class="content"> -<img src="images/DivePlanner2_f20.jpg" alt="FIGURE: Planning a dive: setup" /> +<img src="images/Planner_OC_deco_VPM.jpg" alt="FIGURE: Planning a dive: setup" /> </div> </div> <div class="paragraph"><p>Once the above steps have been completed, save by clicking the <em>Save</em> button @@ -5304,14 +5303,16 @@ the transitions are shown separately from the segment durations at a particular <h3 id="_planning_pscr_dives">14.3. Planning pSCR dives</h3> <div class="paragraph"><p>To plan a dive using a passive semi-closed rebreather (pSCR), select <em>pSCR</em> rather than <em>Open circuit</em> in the dropdown list. -The parameters of the pSCR dive can be set by selecting <em>File → Preferences → Graph</em> +The parameters of the pSCR dive can be set by selecting <em>File → Preferences → Profile</em> from the main menu, where the gas consumption calculation takes into account the pSCR dump ratio (default 1:10) as well as the metabolic rate. The calculation also takes the oxygen drop accross the mouthpiece of the rebreather into account. If the pO<sub>2</sub> drops below what is considered safe, a warning appears in the <em>Dive plan -details</em>. A typical pSCR configuration is with a single cylinder and one or more bail-out -cylinders. Therefore the setup of the <em>Available gases</em> and the <em>Dive planner points</em> tables -are very similar to that of a CCR dive plan, described below. However, no oxygen setpoints +details</em>. A typical pSCR cylinder setup is very similar to an open circuit dive; +one or more drive cilinders, possibly with different bottom and decompression +gasses, including gas switches during the dive like in open circuit diving. +Therefore, the setup of the <em>Available gases</em> and the <em>Dive planner points</em> tables +are very similar to that of a open circuit dive plan, described above. However, no oxygen setpoints are specified for pSCR dives. Below is a dive plan for a pSCR dive. The dive is comparable to that of the CCR dive below, but note the longer ascent duration due to the lower oxygen in the loop due to the oxygen drop across the mouthpiece of the pSCR equipment.</p></div> @@ -5328,7 +5329,7 @@ list, circled in blue in the image below.</p></div> <div class="paragraph"><p><strong>Available gases</strong>: In the <em>Available gases</em> table, enter the cylinder information for the diluent cylinder and for any bail-out cylinders. Do NOT enter the information for the oxygen cylinder since it is implied when the <em>CCR</em> dropdown selection is made.</p></div> -<div class="paragraph"><p><strong>Entering setpoints</strong>: Specify a default setpoint in the Preferences tab, by selecting <em>File → Preferences → Graph</em> from +<div class="paragraph"><p><strong>Entering setpoints</strong>: Specify a default setpoint in the Preferences tab, by selecting <em>File → Preferences → Profile</em> from the main menu. All user-entered segments in the <em>Dive planner points</em> table use the default setpoint value. Then, different setpoints can be specified for dive segments in the <em>Dive planner points</em> table. A zero setpoint @@ -5381,11 +5382,7 @@ planner: the planner takes into account the configuration in the highlighted div <div class="paragraph"><p>Selecting the <em>Print</em> button in the planner allows printing of the <em>Dive Plan Details</em> for wet notes. You can also cut and paste the <em>Dive Plan Details</em> to include in a text file or word processing document.</p></div> -<div class="paragraph"><p>Dive plans have many characteristics in common with dive logs (dive profile, dive notes, etc). -After a dive plan has been saved, the dive details and gas calculations are saved in -the <strong>Notes</strong> tab. While a dive plan is being designed, it can be printed using -the <em>Print</em> button in the dive planner. This prints the dive details and gas calculations -in the <em>Dive Plan Details</em> panel of the dive planner. However, after the plan has been saved, it is +<div class="paragraph"><p>However, after the plan has been saved, it is represented in a way very similar to a dive log and the gas calculations cannot be accessed in the same way as during the planning process. The only way to print the dive plan is to use the <em>File → Print</em> function on the main menu in the @@ -5478,7 +5475,7 @@ cellspacing="0" cellpadding="4"> </tr> <tr> <td align="left" valign="top"><p class="table">--version</p></td> -<td align="left" valign="top"><p class="table">Prints the current version of <em>Subsurface</em>.</p></td> +<td align="left" valign="top"><p class="table">Prints the current version of <em>Subsurface</em></p></td> </tr> <tr> <td align="left" valign="top"><p class="table">--survey</p></td> @@ -5496,6 +5493,10 @@ cellspacing="0" cellpadding="4"> <td align="left" valign="top"><p class="table">--win32console</p></td> <td align="left" valign="top"><p class="table">Create a dedicated console if needed (Windows only). Add this option before everything else</p></td> </tr> +<tr> +<td align="left" valign="top"><p class="table">--win32log</p></td> +<td align="left" valign="top"><p class="table">Write the program output to subsurface.log (Windows only). Add option before everything else</p></td> +</tr> </tbody> </table> </div> @@ -5759,7 +5760,7 @@ The Edit option allows one to undo or redo an action, e.g. deleting dives. <li> <p> <em>Check for updates</em> - Find out whether a newer version of Subsurface is available - on the <a href="http://subsurface-divelog.org/"><em>Subsurface</em> web site</a>. + on the <a href="https://subsurface-divelog.org/"><em>Subsurface</em> web site</a>. </p> </li> <li> @@ -5816,7 +5817,7 @@ On a Mac users sometimes have to manually hunt for the correct devices or any other dive computer using a USB-to-serial interface based on the Silicon Labs CP2101 or similar chip can be found as <em>Mac_OSX_VCP_Driver.zip</em> at the -<a href="http://www.silabs.com/support/pages/document-library.aspx?p=Interface&f=USB%20Bridges&pn=CP2101">Silicon Labs document and software repository</a>. +<a href="https://www.silabs.com/support/pages/document-library.aspx?p=Interface&f=USB%20Bridges&pn=CP2101">Silicon Labs document and software repository</a>. </p> </li> </ul></div> @@ -6028,7 +6029,7 @@ environment of the operating system. After setting the dive computer to upload m and select <em>Add new device</em>. The dive computer should appear. If asked for a password, enter 0000. Write down or copy the MAC address of your dive computer - this needed later and should be in the form 00:11:22:33:44:55.</p></div> <div class="paragraph"><p>If the graphical method doesn’t work, pair the device from the command line. Open a terminal -and use <code>hciconfig</code> to check the Bluetooth controller status</p></div> +and use <code>hciconfig</code> to check the Bluetooth controller status.</p></div> <div class="literalblock"> <div class="content"> <pre><code>$ hciconfig @@ -6053,7 +6054,7 @@ hci0: Type: BR/EDR Bus: USB TX bytes:449 acl:0 sco:0 commands:46 errors:0</code></pre> </div></div> <div class="paragraph"><p>Check that the status now includes <code><em>UP</em>, <em>RUNNING</em> AND <em>AUTH</em></code>.</p></div> -<div class="paragraph"><p>If there are multiple controllers running, it’s easiest to off the unused controller(s). For example, for <code>hci1</code>:</p></div> +<div class="paragraph"><p>If there are multiple controllers running, it’s easiest to turn off the unused controller(s). For example, for <code>hci1</code>:</p></div> <div class="literalblock"> <div class="content"> <pre><code>sudo hciconfig hci1 down</code></pre> @@ -6094,7 +6095,7 @@ Scanning ... 00:11:22:33:44:55 Petrel bluez-simple-agent hci0 00:11:22:33:44:55</code></pre> </div></div> -<div class="paragraph"><p>Once ther dive computer is pired, set up the RFCOMM connection</p></div> +<div class="paragraph"><p>Once the dive computer is paired, set up the RFCOMM connection.</p></div> </div> <div class="sect4"> <h5 id="_establishing_the_rfcomm_connection">Establishing the RFCOMM connection</h5> @@ -6275,7 +6276,7 @@ for every dive. Mark all the dives you’d like to import or open. Note: The DR5 does not seem to store gradient factors nor deco information, so for <em>Subsurface</em> it is not possible to display them. Adjust the gradient -factors in the <em>Graph Settings</em> in <em>Subsurface</em> to generate a deco overlay in the +factors in the <em>Profile Settings</em> in <em>Subsurface</em> to generate a deco overlay in the <em>Subsurface</em> <strong>Dive Profile</strong> panel but please note that the deco calculated by <em>Subsurface</em> will most likely differ from the one displayed on the DR5.</td> </tr></table> @@ -6292,7 +6293,7 @@ factors in the <em>Graph Settings</em> in <em>Subsurface</em> to generate a deco When mounted as a USB drive UDDF files are available in LOGBOOK directory. Note: The xDEEP BLACK saves NDL time but does not seem to store gradient factors nor deco information, so for <em>Subsurface</em> it is not possible to display them. Adjust the gradient -factors in the <em>Graph Settings</em> in <em>Subsurface</em> to generate a deco overlay in the +factors in the <em>Profile Settings</em> in <em>Subsurface</em> to generate a deco overlay in the <em>Subsurface</em> <strong>Dive Profile</strong> panel but please note that the deco calculated by <em>Subsurface</em> will most likely differ from the one displayed on the xDEEP BLACK.</td> </tr></table> @@ -6389,7 +6390,7 @@ Open a text editor, e.g. Notepad (Windows) or TextWrangler (Mac). <li> <p> Copy the contents of the clipboard into the text editor and save the text file - with a filename extension of <em>.apd</em> + with a filename extension of <em>.apd</em>. </p> </li> <li> @@ -6473,7 +6474,7 @@ dive log software. The procedures below mostly apply to Linux and/or Windows.</p <td class="icon"> <img src="images/icons/suuntologo.jpg" alt="Note" /> </td> -<td class="content">DiveManager is a MS Windows application for Suunto dive computers. +<td class="content">DiveManager is a Windows application for Suunto dive computers. Divemanager 3 (DM3) is an older version of the Suunto software. More recent Suunto dive computers use Divemanager version 4 or 5 (DM4 or DM5). The different versions of Divemanager use different methods and different file naming @@ -6642,7 +6643,7 @@ The dives are now exported to the file DM4.bak (or DM5.bak) <td class="icon"> <img src="images/icons/atomiclogo.jpg" alt="Note" /> </td> -<td class="content">Atomic Logbook is a Windows software by Atomic Aquatics. It allows +<td class="content">Atomic Logbook is Windows software by Atomic Aquatics. It allows downloading of dive information from Cobalt and Cobalt 2 dive computers. The divelog is kept in a SQLite database at C:\ProgramData\AtomicsAquatics\Cobalt-Logbook\Cobalt.db. This file can @@ -6754,7 +6755,7 @@ according to which spreadsheet program is used.</p></div> <div class="paragraph"><p>Organize the diving data in the spreadsheet, so the first row contains the names (or titles) of each column and the information for each dive is stored in a single row. <em>Subsurface</em> supports many data items (Dive number, Date, -Time, Duration, Location, GPS, Max Depth, Mean Depth, Buddy, Notes, Weight and Tags). +Time, Duration, Location, GPS, Max. Depth, Mean Depth, Buddy, Notes, Weight and Tags). Organize dive data following a few simple rules:</p></div> <div class="olist arabic"><ol class="arabic"> <li> @@ -6823,7 +6824,7 @@ Open the <em>Regional and Language Options</em> dialog box. </li> <li> <p> -Do one of the following: +Do the following: </p> <div class="ulist"><ul> <li> @@ -6831,11 +6832,6 @@ Do one of the following: In Windows 7, click the <em>Formats</em> tab, and then click <em>Customize this format</em>. </p> </li> -<li> -<p> -In Windows XP, click the <em>Regional Options</em> tab, and then click <em>Customize</em>. -</p> -</li> </ul></div> </li> <li> @@ -6940,7 +6936,7 @@ dialogue to save the new template using a new template name.</p></div> <h1> 2 </h1> <h1> 3 </h1></code></pre> </div></div> -<div class="paragraph"><p>Additional information about <em>Grantlee</em> can be found at <a href="http://www.grantlee.org/apidox/for_themers.html">here</a></p></div> +<div class="paragraph"><p>Additional information about <em>Grantlee</em> can be found <a href="http://www.grantlee.org/apidox/for_themers.html">here</a></p></div> </div> <div class="sect2"> <h3 id="_grantlee_exported_variables">21.2. Grantlee exported variables</h3> @@ -6987,7 +6983,7 @@ cellspacing="0" cellpadding="4"> </tr> <tr> <td align="left" valign="top"><p class="table">divemaster</p></td> -<td align="left" valign="top"><p class="table">(<strong>string</strong>) dive master for the dive</p></td> +<td align="left" valign="top"><p class="table">(<strong>string</strong>) divemaster for the dive</p></td> </tr> <tr> <td align="left" valign="top"><p class="table">buddy</p></td> @@ -7172,7 +7168,7 @@ cellspacing="0" cellpadding="4"> </div> <div class="sect2"> <h3 id="_defined_css_selectors">21.3. Defined CSS selectors</h3> -<div class="paragraph"><p>As the dive profile is placed after rendering, <em>Subsurface</em> uses special <em>CSS</em> selectors to searche +<div class="paragraph"><p>As the dive profile is placed after rendering, <em>Subsurface</em> uses special <em>CSS</em> selectors to search in the HTML output. The <em>CSS</em> selectors in the following table should be added.</p></div> <div class="tableblock"> <table rules="all" @@ -7324,7 +7320,7 @@ cannot be salvaged after being overwritten by new dives.</p></div> <div id="footnotes"><hr /></div> <div id="footer"> <div id="footer-text"> -Last updated 2017-01-15 11:35:43 PST +Last updated 2017-04-13 11:03:51 PDT </div> </div> </body> |