1
0
Fork 0
mirror of https://github.com/subsurface/subsurface.git synced 2025-02-19 22:16:15 +00:00

User manual: last changes before V4.5

1) Run a spell checker through the user manual. Only three
   outright typos found!!
2) Correct sentence about reverse name lookup that results in
   dive site name reported in tags field, not in Location field.
   (Sergey, thank you!)

Signed-off-by: Willem Ferguson <willemferguson@zoology.up.ac.za>
Signed-off-by: Dirk Hohndel <dirk@hohndel.org>
This commit is contained in:
Willem Ferguson 2015-10-13 17:39:07 +02:00 committed by Dirk Hohndel
parent 58533dd493
commit 8d546bc8c0

View file

@ -389,7 +389,7 @@ of the dive computer (at least for those not charging while connected via USB).
progress information could be inaccurate as we cannot determine how much
downloadable data there is until all data have been downloaded). After successful download, Dialogue *B*
in the figure above appears.
After the dives have been downloaded, they appear in a tabular format on the righthand
After the dives have been downloaded, they appear in a tabular format on the right-hand
side of the dialogue (see image *B*, above). Each dive comprises a row in the table, with the date, duration
and depth shown. Next to each dive is a checkbox: check all the dives that need to
be transferred to the *Dive List*. In the case of the image above, the last six dives are
@ -489,7 +489,7 @@ check box labelled _"Choose Bluetooth download mode"_, the dialogue below appear
image::images/DC_import_Bluetooth.jpg["FIGURE: Download Bluetooth",align="center"]
On the _Linux_ or _MacOS_ platforms the name
of the _Subsurface_ computer and its Bluetooth address are shown on the righthand side, On the lefthand side, if the
of the _Subsurface_ computer and its Bluetooth address are shown on the right-hand side, On the lefthand side, if the
computer has connected more than one local Bluetooth devices the user can use
the list box to indicate which one needs to connect to _Subsurface_.
The power state (on/off) of the Bluetooth adapter is shown below
@ -631,7 +631,7 @@ The *Time* field reflects the date and time of the dive. By clicking
the date, a calendar is displayed from which
one can choose the correct date. Press ESC to close the calendar.
The time values (hour and minutes) can also be
edited directly by clicking on each of them in the text box and by overtyping the
edited directly by clicking on each of them in the text box and by over-typing the
information displayed.
*Air/water temperatures*: Air and water temperatures during the dive are shown
@ -670,7 +670,7 @@ The dive site names in the dropdown list contain either a globe symbol (indicati
existing dive sites in the _Subsurface_ database)
or a *+* symbol (indicating dive site names that appear consistent with the
current dive site name but which have not been added to the dive site database).
Therfore, if the present
Therefore, if the present
dive site has not been used before, a message appears as follows (image *A* below):
image::images/Locations1_f22.jpg["FIGURE:Location description panel",align="center"]
@ -717,7 +717,7 @@ same).
text box, one can perform an automated name lookup based on the coordinates.
This is achieved when _Subsurface_ uses the Internet to find the name of the dive site
based on the coordinates that were typed. If a name has been found, it is
automatically inserted into the text box titled _Location_. The list box
automatically inserted into the tags box. The list box
(Titled _Dive sites on same coordinates_") at the bottom
of the dive site panel contains the names of other dives sites used at the
current location. For instance if the dive site is "Blue Hole" and there are several
@ -1103,7 +1103,7 @@ b. Which data columns need to be imported into _Subsurface_? Is it a _CSV dive d
file or a _CSV dive profile_ file? Open the file using a text editor and note
the titles of the columns to be imported and their column positions.
c. Is the numeric information (e.g. dive depth) in metric or in imperial unis?
c. Is the numeric information (e.g. dive depth) in metric or in imperial units?
Armed with this information, importing the data into _Subsurface_ is
straightforward. Select
@ -1132,7 +1132,7 @@ instance, _Subsurface_ expects the column heading for Dive number (" # ") to be
the column heading that _Subsurface_ expects is not in the blue row, then drag the
appropriate balloon from the upper area and drop it in the appropriate blue
cell at the top of the table. To indicate the correct column for "Dive #", drag
the ballooned item labeled "Dive # " and drop it in the blue
the ballooned item labelled "Dive # " and drop it in the blue
cell immediately above the white cell containing " # ". This is depicted in
the image below.
@ -1445,7 +1445,7 @@ service is running one can only add dives using the manual mechanism.
One can edit the site name afterwards by selecting the dive
from the dive list and clicking on the site name. There are no other
editable fields. The dive list is automatically uploaded from the iphone
editable fields. The dive list is automatically uploaded from the iPhone
to the webservice and there is not an option to
trigger upload manually.
@ -1673,10 +1673,10 @@ _Subsurface_ automatically checks and, if necessary, updates the fingerprints as
[[S_MulticylinderDives]]
==== Multicylinder dives
_Subsurface_ easily handles dives involving more than one cylinder. Multicylinder diving usually happens
_Subsurface_ easily handles dives involving more than one cylinder. Multi-cylinder diving usually happens
(a) if a diver does not have enough gas for the complete dive in a single cylinder; (b) if the diver
needs more than one gas mixture because of the depth or the decompression needs of the dive. For this reason
multicylinder dives are often used by technical divers who dive deep or long. As far
multi-cylinder dives are often used by technical divers who dive deep or long. As far
as _Subsurface_ is concerned, there are only two types of information that need to be provided:
- *Describe the cylinders used during the dive* This is performed in the *Equipment tab* of
@ -1704,10 +1704,10 @@ image::images/multicylinder_dive.jpg["FIGURE: Multicylinder profile",align="cent
==== Sidemount dives
Sidemount diving is just another form of multicylinder diving, often with both or all cylinders having
Sidemount diving is just another form of multi-cylinder diving, often with both or all cylinders having
the same gas mixture. Although it is a popular configuration for cave divers, sidemount
diving can be performed by recreational divers who have completed the appropriate training. Sidemount
dive logging involves, exactly as with multicylinder dives, above, three steps:
dive logging involves, exactly as with multi-cylinder dives, above, three steps:
- *During the dive, record cylinder switch events*. Since sidemount diving normally involves two
cylinders with air or with the same gas mixture, _Subsurface_ distinguishes among these different
@ -2407,7 +2407,7 @@ Users can unlink dives from the trip to which they belong. In order to do this,
select and right-click
the relevant dives to bring up the context menu. Then select the option *Remove dive(s)
from trip*. The dive(s) now appear immediately above or below the trip to
which they belonged, depending on the date and time of the unliked dive.
which they belonged, depending on the date and time of the unlinked dive.
==== Add a dive to the trip immediately above
@ -2794,7 +2794,7 @@ See <<_appendix_a_operating_system_specific_information_for_importing_dive_infor
Once the dive computer is connected to the _Subsurface_ computer, select _File -> Configure dive
computer_ from the _Main Menu_. Provide the appropriate device name in the text box at the
top of the configuration panel and select the appropriate dive
computer model from the panel on the lefthand (see image below).
computer model from the panel on the left-hand (see image below).
image::images/Configure_dc_f20.jpg["FIGURE: Configure dive computer",align="center"]
@ -2815,7 +2815,7 @@ Using the appropriate buttons on the configuration panel, the following actions
[[S_Preferences]]
== Setting user _Preferences_ for _Subsurface_
There are several user-defineable settings within _Subsurface_, found by selecting
There are several user-definable settings within _Subsurface_, found by selecting
_File -> Preferences_. The settings are performed in
seven groups: *Defaults*, *Units*, *Graph*, *Language* and *Network*, *Facebook* and *Georeference*,
all of which
@ -2890,7 +2890,7 @@ This panel allows two type of selections:
the dive, enabled by using the toolbar on the left hand side of the *Dive Profile*
panel. For each of these graphs users can specify a threshold value on the right-hand side of the
Preferences panel. If any of the graphs go above the specified threshold level, the graph is
highlighted in red, indicating that the particular partial presure threshold has been exceeded.
highlighted in red, indicating that the particular partial pressure threshold has been exceeded.
** _Max pO~2~ is used for calculating the MOD when displaying the maximum operative depth (MOD)
for a dive. Specify an appropriate partial pressure. A value of 1.4 is commonly used.
** _Draw dive computer reported ceiling red_: This checkbox allows exactly what it says. By default
@ -3084,7 +3084,7 @@ image::images/PlannerWindow1_f20.jpg["FIGURE: Dive planner startup window",align
pressure of this cylinder. By leaving the oxygen concentration (O2%) filed 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 righthand of the dialogue.
"+" icon to the top right-hand of the dialogue.
- The profile of the planned dive can be created in two ways:
* Drag the waypoints
@ -3108,7 +3108,7 @@ It computes the maximal time a diver can stay at the current depth without incur
stops and without using more than the existing gas (minus a reserve). The planner automatically takes
into account the nitrogen load incurred in previous dives. But conventional dive tables are also used in a
way that can take into account previous dives. Why use a dive planner for recreational dives? Using
recreational dive tables, the maximum depth of a dive is taken into acount. However, few dives are
recreational dive tables, the maximum depth of a dive is taken into account. However, few dives are
undertaken at a constant depth corresponding to the maximum depth (i.e. a "square" dive profile). This means
that dive tables overestimate the nitrogen load incurred during previous dives. The _Subsurface_
dive planner calculates nitrogen load according to the real dive profiles of all uploaded previous dives,
@ -3467,7 +3467,6 @@ dealing with the appropriate operations.
== APPENDIX A: Operating system specific information for importing dive information from a dive computer.
=== Make sure that the OS has the required drivers installed