[PATCH] Documentation: Fix user-manual.txt indentation to comply to asciidoc format (also fix po4a translation tool usage)
Guillaume GARDET
guillaume.gardet at free.fr
Thu Jan 15 01:26:42 PST 2015
This patch fix indentation for list item to comply to asciidoc format.
This also fix po4a translation tool usage.
Signed-off-by: Guillaume GARDET <guillaume.gardet at free.fr>
---
Documentation/user-manual.txt | 695 +++++++++++++++++++++---------------------
1 file changed, 347 insertions(+), 348 deletions(-)
diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
index e7c5d96..ad7cab7 100644
--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt
@@ -161,28 +161,28 @@ _Subsurface_ allows several ways of adding dive data to a logbook, detailed
in the following sections.
1) If the user has a handwritten divelog, a spreadsheet or another form of
-manually maintained divelog, dive data can be added to the logbook using
-one of these approaches:
+ manually maintained divelog, dive data can be added to the logbook using
+ one of these approaches:
-- Enter dive information by hand. This is useful if the diver did not
-use a dive computer and dives were recorded in a written logbook. See:
-xref:S_EnterData[Entering dive information by hand]
+ - Enter dive information by hand. This is useful if the diver did not
+ use a dive computer and dives were recorded in a written logbook. See:
+ xref:S_EnterData[Entering dive information by hand]
-- Import dive log information that has been maintained either as a spreadsheet
-or as a CSV file. Refer to: xref:S_Appendix_D[APPENDIX D: Exporting a spreadsheet to CSV format]
-and the text about xref:S_ImportingManualCSV[Importing dives from manually created CSV files] and
+ - Import dive log information that has been maintained either as a spreadsheet
+ or as a CSV file. Refer to: xref:S_Appendix_D[APPENDIX D: Exporting a spreadsheet to CSV format]
+ and the text about xref:S_ImportingManualCSV[Importing dives from manually created CSV files] and
2) If one has dives recorded using a dive computer, the depth profile of the
-dive and a large amount of additional information can be accessed. These dives
-can be imported from:
+ dive and a large amount of additional information can be accessed. These dives
+ can be imported from:
-- The divecomputer itself. See: xref:S_ImportDiveComputer[Importing new dive information from a Dive Computer] or
+ - The divecomputer itself. See: xref:S_ImportDiveComputer[Importing new dive information from a Dive Computer] or
-- Proprietary software distributed by manufacturers of dive computers. Refer
-to: xref:S_ImportingAlienDiveLogs[Importing dive information from other digital data sources or other data formats].
+ - Proprietary software distributed by manufacturers of dive computers. Refer
+ to: xref:S_ImportingAlienDiveLogs[Importing dive information from other digital data sources or other data formats].
-- Import from spreadsheet or CSV files containing dive profiles.
-See: xref:S_ImportingCSVDives[Importing dives in CSV format from dive computers or other dive log software]
+ - Import from spreadsheet or CSV files containing dive profiles.
+ See: xref:S_ImportingCSVDives[Importing dives in CSV format from dive computers or other dive log software]
[[S_EnterData]]
@@ -248,19 +248,19 @@ frequently dives at the same sites.
here. These can come from three sources:
a. One can find the coordinates on the world map in the bottom right hand
-part
-of the Subsurface window. The map displays a green bar indicating "No location
-data - Move the map and double-click to set the dive location". Upon a double-click
-at the appropriate place, the green bar disappears and the coordinates are
-stored.
+ part
+ of the Subsurface window. The map displays a green bar indicating "No location
+ data - Move the map and double-click to set the dive location". Upon a double-click
+ at the appropriate place, the green bar disappears and the coordinates are
+ stored.
b. The coordinates can be obtained from the _Subsurface_ Companion app if the
-user has an Android device with GPS and if the coordinates of the dive site
-were stored using that device.
-xref:S_Companion[Click here for more information]
+ user has an Android device with GPS and if the coordinates of the dive site
+ were stored using that device.
+ xref:S_Companion[Click here for more information]
c. The coordinates can be entered by hand if they are known, using one of
-four formats with latitude followed by longitude:
+ four formats with latitude followed by longitude:
ISO 6709 Annex D format e.g. 30°13'28.9"N 30°49'1.5"E
Degrees and decimal minutes, e.g. N30° 13.49760' , E30° 49.30788'
@@ -510,8 +510,8 @@ achieved by following these steps:
(Users should refer to the manual of their specific dive computer)
3. In _Subsurface_, from the Main Menu, the user must select _Import -> Import
-From Dive Computer_.
-Dialogue *A* in the figure below appears:
+ From Dive Computer_.
+ Dialogue *A* in the figure below appears:
image::images/ImportFromDC1_f20.jpg["FIGURE: Download dialogue 1",align="center"]
@@ -526,22 +526,22 @@ even though some may already be in the logbook, then check the check box labelle
_Force download of all dives_.
- The dialogue has two drop-down lists, *Vendor* and *Dive Computer*. On the
-*vendor* drop-down list select the make of the computer, e.g.
-Suunto, Oceanic,
-Uwatec, Mares. On the *Dive Computer* drop-down list, the model name of
-the dive computer must be selected, e.g. D4 (Suunto), Veo200 (Oceanic), or Puck
-(Mares).
+ *vendor* drop-down list select the make of the computer, e.g.
+ Suunto, Oceanic,
+ Uwatec, Mares. On the *Dive Computer* drop-down list, the model name of
+ the dive computer must be selected, e.g. D4 (Suunto), Veo200 (Oceanic), or Puck
+ (Mares).
- The *Device or Mount Point* drop-down list contains the USB or Bluetooth port
-name that _Subsurface_ needs in order to communicate with the dive computer.
-The appropriate port name must be selected. Consult
-xref:_appendix_a_operating_system_specific_information_for_importing_dive_information_from_a_dive_computer[Appendix A]
-and
-xref:_appendix_b_dive_computer_specific_information_for_importing_dive_information[Appendix B]
-for technical details on how to find the appropriate port information for a
-particular dive
-computer and, in some cases, how to do the correct settings to the operating
-system of the computer on which _Subsurface_ is running.
+ name that _Subsurface_ needs in order to communicate with the dive computer.
+ The appropriate port name must be selected. Consult
+ xref:_appendix_a_operating_system_specific_information_for_importing_dive_information_from_a_dive_computer[Appendix A]
+ and
+ xref:_appendix_b_dive_computer_specific_information_for_importing_dive_information[Appendix B]
+ for technical details on how to find the appropriate port information for a
+ particular dive
+ computer and, in some cases, how to do the correct settings to the operating
+ system of the computer on which _Subsurface_ is running.
- If all the dives on the dive computer need to be downloaded, check the
checkbox _Force download of all dives_. Normally, _Subsurface_ only downloads
@@ -559,32 +559,32 @@ system of the computer on which _Subsurface_ is running.
*Dive List* panel, the record in the _Subsurface_ divelog will be overwritten
by the record from the dive computer
- - Do *not* check the checkboxes labelled _Save libdivecomputer logfile_ and
- _Save libdivecomputer dumpfile_. These are only used as diagnostic tools
- when problems with downloads are experienced (see below).
+ - Do *not* check the checkboxes labelled _Save libdivecomputer logfile_ and
+ _Save libdivecomputer dumpfile_. These are only used as diagnostic tools
+ when problems with downloads are experienced (see below).
- - The _OK_ button must then be clicked. Dialogue *B* in the figure above
-appears.
+ - The _OK_ button must then be clicked. Dialogue *B* in the figure above
+ appears.
- With communication established, one can see how the data are
-retrieved from the dive computer.
-Depending on the make of the dive computer and/or number of recorded dives, this
-could take some time. The user should be patient. The _Download_ dialogue
-shows a
-progress bar at the bottom of the dialogue (for some dive computers the
-progress information could be inaccurate as we cannot determine how much
-downloadable data there is until all data have been downloaded). When the
-download of the dive information is complete, all the imported dives appear
-in the *Dive List*, sorted by date and time. Disconnect and
-switch off the dive
-computer to conserve its battery power.
-If a particular dive is selected, the *Dive Profile* panel shows an informative
-graph of dive depth against time for that particular dive.
+ retrieved from the dive computer.
+ Depending on the make of the dive computer and/or number of recorded dives, this
+ could take some time. The user should be patient. The _Download_ dialogue
+ shows a
+ progress bar at the bottom of the dialogue (for some dive computers the
+ progress information could be inaccurate as we cannot determine how much
+ downloadable data there is until all data have been downloaded). When the
+ download of the dive information is complete, all the imported dives appear
+ in the *Dive List*, sorted by date and time. Disconnect and
+ switch off the dive
+ computer to conserve its battery power.
+ If a particular dive is selected, the *Dive Profile* panel shows an informative
+ graph of dive depth against time for that particular dive.
- If there is a problem in communicating with the dive computer, an error
-message will be shown, similar to this text: "Unable to open /dev/ttyUSB0 Mares
-(Puck Pro)". Refer to the text in the box below.
+ message will be shown, similar to this text: "Unable to open /dev/ttyUSB0 Mares
+ (Puck Pro)". Refer to the text in the box below.
****
@@ -594,23 +594,23 @@ message will be shown, similar to this text: "Unable to open /dev/ttyUSB0 Mares
Check the following:
- Is the dive computer still in PC-communication or
-Upload mode?
+ Upload mode?
- Is the battery of the dive computer fully charged? If not then the battery
-must be charged or replaced.
+ must be charged or replaced.
- Is the connecting cable faulty? Does the cable work perfectly using other
-software? Has it worked before, or is this the first time the cable is being used? Are the contacts
-on the dive computer and the cable clean?
+ software? Has it worked before, or is this the first time the cable is being used? Are the contacts
+ on the dive computer and the cable clean?
- Consult
-xref:_appendix_a_operating_system_specific_information_for_importing_dive_information_from_a_dive_computer[Appendix A]
-and make sure that the correct Mount Point
-was specified (see above).
+ xref:_appendix_a_operating_system_specific_information_for_importing_dive_information_from_a_dive_computer[Appendix A]
+ and make sure that the correct Mount Point
+ was specified (see above).
- On Unix-like operating systems, does the user have write permission to the
-USB port? If not, consult
-xref:_appendix_a_operating_system_specific_information_for_importing_dive_information_from_a_dive_computer[Appendix A]
+ USB port? If not, consult
+ xref:_appendix_a_operating_system_specific_information_for_importing_dive_information_from_a_dive_computer[Appendix A]
If the _Subsurface_ computer does not recognise the USB adaptor by
showing an appropriate device name next to the Mount Point, then there is a
@@ -709,19 +709,19 @@ make this easier if one frequently dives at the same sites.
here. These can come from three sources:
a. The user can find the coordinates on the world map in the bottom right hand
-part
-of the Subsurface window. The map displays a green bar indicating "Move the map
-and double-click to set the dive location". Double-click
-at the appropriate place, the green bar disappears and the coordinates are
-stored.
+ part
+ of the Subsurface window. The map displays a green bar indicating "Move the map
+ and double-click to set the dive location". Double-click
+ at the appropriate place, the green bar disappears and the coordinates are
+ stored.
b. The user can obtain the coordinates from the _Subsurface_ Companion app if
-an Android device with GPS was used and if the coordinates of the dive site
-were stored using that device.
-xref:S_Companion[Click here for more information]
+ an Android device with GPS was used and if the coordinates of the dive site
+ were stored using that device.
+ xref:S_Companion[Click here for more information]
c. The coordinates can be entered by hand if they are known, using one of
-four formats with latitude followed by longitude:
+ four formats with latitude followed by longitude:
ISO 6709 Annex D format e.g. 30°13'28.9"N 30°49'1.5"E
Degrees and decimal minutes, e.g. N30° 13.49760' , E30° 49.30788'
@@ -904,16 +904,16 @@ during the dive, e.g. "Saw dolphins", or "Released surface buoy". This is easily
done:
- Right-click at the appropriate point on the dive profile.
-This brings up the dive profile context menu. Select _Add bookmark_. A red flag is
-placed on the dive profile at the point that was initially selected (see *A* below).
+ This brings up the dive profile context menu. Select _Add bookmark_. A red flag is
+ placed on the dive profile at the point that was initially selected (see *A* below).
- Right-click on the red flag. This brings up the context menu (see *B* below). Select _Edit name_.
- A text box is shown. Type the explanatory text for the bookmark (see *C* below). Select _OK_.
-This saves the text associated with the bookmark.
+ This saves the text associated with the bookmark.
- If one hovers using the mouse over the red bookmark, the appropriate text is shown at
-the bottom of the information box (see *D* below).
+ the bottom of the information box (see *D* below).
image::images/Bookmarks.jpg["FIGURE: Bookmark dialog",align="center"]
@@ -1001,14 +1001,14 @@ gas that has been breathed while doing two things to maintain a
breathable oxygen concentration:
a) remove carbon dioxide from the gas that has been exhaled
b) regulate the oxygen concentration to remain within safe diving limits.
-Currently, within _Subsurface_, the Poseidon MkVI Discovery is the best
-supported CCR dive computer. The CCR interface of _Subsurface_ is currently experimental
-and under active development. In contrast to a conventional open circuit
-dive computer, a CCR system computer does not allow the download of a log
-containing multiple dives. Rather, each dive is stored independently. This
-means that _Subsurface_ cannot download a dive log directly from a CCR
-dive computer, but that it imports CCR dive logs in the same way that it
-imports dive log data from other databases.
+ Currently, within _Subsurface_, the Poseidon MkVI Discovery is the best
+ supported CCR dive computer. The CCR interface of _Subsurface_ is currently experimental
+ and under active development. In contrast to a conventional open circuit
+ dive computer, a CCR system computer does not allow the download of a log
+ containing multiple dives. Rather, each dive is stored independently. This
+ means that _Subsurface_ cannot download a dive log directly from a CCR
+ dive computer, but that it imports CCR dive logs in the same way that it
+ imports dive log data from other databases.
===== Import a CCR dive
@@ -1055,17 +1055,17 @@ _Subsurface_. Mares dive logs need to be imported using a three-step process,
using _www.divelogs.de_ as a mechanism to extract the dive log information.
1. The dive log data from Mares Dive Organiser need to be exported to the user's
-desktop, using
- a _.sdf_ file name extension. Refer to xref:Mares_Export[Appendix C] for more
-information.
+ desktop, using
+ a _.sdf_ file name extension. Refer to xref:Mares_Export[Appendix C] for more
+ information.
2. Data should then be imported into _www.divelogs.de_. One needs to create a user
-account in
-_www.divelogs.de_, log into that web site, then
-select _Import Logbook -> Dive Organiser_ from the menu on the left hand side.
-The instructions must be carefully followed to transfer the dive information
-(in _.sdf_ format) from the Dive Organiser database to _www.divelogs.de_.
+ account in
+ _www.divelogs.de_, log into that web site, then
+ select _Import Logbook -> Dive Organiser_ from the menu on the left hand side.
+ The instructions must be carefully followed to transfer the dive information
+ (in _.sdf_ format) from the Dive Organiser database to _www.divelogs.de_.
3. Finally, import the dives
-from _divelogs.de_ to _Subsurface_, using the instructions below.
+ from _divelogs.de_ to _Subsurface_, using the instructions below.
[[S_ImportingDivelogsDe]]
@@ -1113,17 +1113,17 @@ Exporting a spreadsheet to CSV format].
Before being able to import the data to _Subsurface_ one needs to know:
a. Which character separates the different columns within a single line of
-data? This field separator should be either a comma (,) or a TAB character.
-This can be determined by opening the file with a text editor. If it is
-comma-delimited, then the comma
-characters between the values are clearly visible. If no commas are evident and
-the numbers are aligned in columns,
-the file is probably TAB-delimited (i.e. it uses a TAB as a field separator, as
-in the above example).
+ data? This field separator should be either a comma (,) or a TAB character.
+ This can be determined by opening the file with a text editor. If it is
+ comma-delimited, then the comma
+ characters between the values are clearly visible. If no commas are evident and
+ the numbers are aligned in columns,
+ the file is probably TAB-delimited (i.e. it uses a TAB as a field separator, as
+ in the above example).
b. Which data columns need to be imported into _Subsurface_? The Dive Time and
-Depth columns are always required. Open the file using a text editor and note
-the titles of the columns to be imported and their column positions.
+ Depth columns are always required. 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?
@@ -1249,23 +1249,23 @@ When importing dives in CSV format (see above), one needs to
know the internal format of the CSV data to import.
a. Which character separates the different columns within a single line of
-data?
-A recommended field separator for the export is TAB, as commas might be part of
-the decimal data values themselves. Therefore the use of an appropriate field separator
-is very important. When exporting data from a spreadsheet it is likely to
-request the user to supply an appropriate field separator character.
+ data?
+ A recommended field separator for the export is TAB, as commas might be part of
+ the decimal data values themselves. Therefore the use of an appropriate field separator
+ is very important. When exporting data from a spreadsheet it is likely to
+ request the user to supply an appropriate field separator character.
b. Which columns need to be imported into _Subsurface_? Currently there
-are not any mandatory input fields, but some, e.g. dive duration
-are crucial for the log file to make any sense. Possible options
-can be seen in the image below and one should include as many as possible of the
-fields available in the original log file.
+ are not any mandatory input fields, but some, e.g. dive duration
+ are crucial for the log file to make any sense. Possible options
+ can be seen in the image below and one should include as many as possible of the
+ fields available in the original log file.
c. Units used for depth, weight and temperature. We consider depth to be
-either feet or meters, weight kilograms or pounds and temperature either
-Celsius or Fahrenheit. However, the users can select _Metric_ or
-_Imperial_ in the *Preferences* tab of _Subsurface_. No mixture of unit
-systems is allowed for the different fields.
+ either feet or meters, weight kilograms or pounds and temperature either
+ Celsius or Fahrenheit. However, the users can select _Metric_ or
+ _Imperial_ in the *Preferences* tab of _Subsurface_. No mixture of unit
+ systems is allowed for the different fields.
Importing manually kept CSV log files is quite straight forward, but
there might be many fields and counting the field numbers is error
@@ -1302,30 +1302,30 @@ To do this:
==== Create a Companion App account
- Register on the http://api.hohndel.org/login/[_Subsurface companion web page_].
-A confirmation email with instructions and a personal *DIVERID* will be sent,
-a long number that gives access to the file server and Companion App capabilities.
+ A confirmation email with instructions and a personal *DIVERID* will be sent,
+ a long number that gives access to the file server and Companion App capabilities.
- Download the app from
-https://play.google.com/store/apps/details?id=org.subsurface[Google Play Store]
-or from
-http://f-droid.org/repository/browse/?fdfilter=subsurface&fdid=org.subsurface[F-Droid].
+ https://play.google.com/store/apps/details?id=org.subsurface[Google Play Store]
+ or from
+ http://f-droid.org/repository/browse/?fdfilter=subsurface&fdid=org.subsurface[F-Droid].
==== Using the Subsurface companion app on a smartphone
On first use the app has three options:
* _Create a new account._ Equivalent to registering in _Subsurface_ companion
-page using an Internet browser. One can request a *DIVERID* using this option,
-but this is supplied via email and followed up by interaction with the
-http://api.hohndel.org/login/[_Subsurface companion web page_] in order to
-activate the account.
+ page using an Internet browser. One can request a *DIVERID* using this option,
+ but this is supplied via email and followed up by interaction with the
+ http://api.hohndel.org/login/[_Subsurface companion web page_] in order to
+ activate the account.
* _Retrieve an account._ If users forgot their *DIVERID* they will receive an email
-to recover the number.
+ to recover the number.
* _Use an existing account._ Users are prompted for their *DIVERID*. The app saves
-this *DIVERID* and does not ask for it again unless one uses the _Disconnect_ menu
-option (see below).
+ this *DIVERID* and does not ask for it again unless one uses the _Disconnect_ menu
+ option (see below).
[icon="images/icons/important.png"]
[IMPORTANT]
@@ -1345,25 +1345,25 @@ Touch the "+" icon on the top right to add a new dive site, a menu will be
showed with 3 options:
* Current: A prompt for a place name (or a request to activate the GPS if it is turned
-off) will be displayed, after which the current location is saved.
+ off) will be displayed, after which the current location is saved.
* Use Map: This option allows the user to fix a position by searching a world map. A
-world map is shown (see *B* below) on which one should indicate the desired position
-with a _long press_ on the touch
-sensitive screen (if the marked location is erroneous, simply indicate a new location)
-and select the check symbol in the upper right. A dialog is shown allowing to enter the
-name of the dive location and the date-time of the dive (see *C* below). In order to import this
-dive location in _Subsurface_ it's advisable to set the time to agree with the time of
-that dive on the dive computer.
+ world map is shown (see *B* below) on which one should indicate the desired position
+ with a _long press_ on the touch
+ sensitive screen (if the marked location is erroneous, simply indicate a new location)
+ and select the check symbol in the upper right. A dialog is shown allowing to enter the
+ name of the dive location and the date-time of the dive (see *C* below). In order to import this
+ dive location in _Subsurface_ it's advisable to set the time to agree with the time of
+ that dive on the dive computer.
image::images/Companion_5.jpg["FIGURE: Companion App, add location using map",align="center"]
* Import local GPX file: The android device searches for .gpx files and located
-archives will be shown. The selected .gpx file is opened and the stored
-locations shown. Now one needs to select the appropriate locations, then select the
-tab in the upper right, after which the locations will be sent to the web service
-and added to the list on the Android device.
+ archives will be shown. The selected .gpx file is opened and the stored
+ locations shown. Now one needs to select the appropriate locations, then select the
+ tab in the upper right, after which the locations will be sent to the web service
+ and added to the list on the Android device.
===== Dive lists of dive locations
@@ -1424,16 +1424,16 @@ Selecting the _Settings_ menu option results in the right hand image above (*B*)
- _Web-service URL._ This is predefined (http://api.hohndel.org/)
- _User ID._ The DIVERID obtained by registering as described above. The easiest way to
-obtain it is simply to copy and paste from the confirmation email but, of
-course, users can also type this information.
+ obtain it is simply to copy and paste from the confirmation email but, of
+ course, users can also type this information.
===== Synchronisation
- _Synchronize on startup._ If selected, dive locations in the Android device and those
-on the web service synchronise each time the app is started.
+ on the web service synchronise each time the app is started.
- _Upload new dives._ If selected, each time the user adds a dive location it is
-automatically sent to the server.
+ automatically sent to the server.
===== Background service
Instead of entering a unique dive location, users can leave the service running
@@ -1443,7 +1443,7 @@ in the background of their Android device, allowing the continuous collection of
The settings below define the behaviour of the service:
- _Min duration._ In minutes. The app will try to get a location every X minutes
-until stopped by the user.
+ until stopped by the user.
- _Min distance._ In meters. Minimum distance between two locations.
@@ -1530,15 +1530,15 @@ downloading GPS data.
TIPS:
- _Background service_, being a very powerful tool, may fill the location list with
-many unnecessary locations not corresponding to the exact dive point but reflecting the boat's route.
-Currently these locations are difficult to delete from the server. In some situations it
-is therefore prudent to clean up the list on the Android device before sending the dive points to the web
-server by simply deleting the inappropriate locations. This might be necessary, for
-instance, if one wants to keep the location list clear to see dives in the web service map display (see above).
+ many unnecessary locations not corresponding to the exact dive point but reflecting the boat's route.
+ Currently these locations are difficult to delete from the server. In some situations it
+ is therefore prudent to clean up the list on the Android device before sending the dive points to the web
+ server by simply deleting the inappropriate locations. This might be necessary, for
+ instance, if one wants to keep the location list clear to see dives in the web service map display (see above).
- It may also make sense to give informative names to the locations sent to the web server, or at least
-to use an informative name in the _Name Template_ setting while running the _background service_,
-especially on a dive trip with many dives and dive locations.
+ to use an informative name in the _Name Template_ setting while running the _background service_,
+ especially on a dive trip with many dives and dive locations.
[[S_LoadImage]]
=== Adding photographs to dives
@@ -1571,35 +1571,35 @@ the dive profile.
_Subsurface_ achieves this synchronisation in two ways:
- *Manually*: If the user wrote down the exact camera time at the start of a dive, the
-difference in time between the two devices can be determined. Actually, as long as the device
-settings for time has not been changed in either device, one could write down the times of
-both devices after the dive or even at the end of the day. One can then manually set the time
-difference in the _Time shift_ dialog. Towards the top of the dialog is a time setting tool
-immediately under the heading _Shift times of image(s) by_, evident in figure *A* below.
-If the camera time is 7 minutes later than that of the dive computer, set the time setting
-tool to a value of 00:07. Select either the _earlier_ or _later_ radio button.
-In the above example, the _earlier_ option is appropriate, since the photos need to be shifted
-7 minutes earlier (camera is 7 minutes ahead of dive computer). Ignore any "AM" or "PM" suffix
-in that tool. Click the _OK_ button and synchronisation is achieved.
+ difference in time between the two devices can be determined. Actually, as long as the device
+ settings for time has not been changed in either device, one could write down the times of
+ both devices after the dive or even at the end of the day. One can then manually set the time
+ difference in the _Time shift_ dialog. Towards the top of the dialog is a time setting tool
+ immediately under the heading _Shift times of image(s) by_, evident in figure *A* below.
+ If the camera time is 7 minutes later than that of the dive computer, set the time setting
+ tool to a value of 00:07. Select either the _earlier_ or _later_ radio button.
+ In the above example, the _earlier_ option is appropriate, since the photos need to be shifted
+ 7 minutes earlier (camera is 7 minutes ahead of dive computer). Ignore any "AM" or "PM" suffix
+ in that tool. Click the _OK_ button and synchronisation is achieved.
image::images/LoadImage3b_f20.jpg["FIGURE: Synchronisation dialog",align="center"]
- *By photograph*: There is a very slick way of achieving synchronisation. If one takes a
-photograph of the face of the dive computer showing the time, then _Subsurface_ can obtain
-the exact time the photograph was taken, using the metadata that the camera stores within
-each photo. In order to do this, use the bottom half of the Time shift_ dialog. If one uses
-the bottom part, the top part of the dialog is ignored. Click on
-the horizontal bar entitled "_Select image of divecomputer showing time_. This brings up
-a file browser with which one can select the photograph of the dive computer. Select the
-photograph using the file browser and click on _OK_. This photograph of the dive computer
-appears in the bottom panel of the _Shift times_ dialog. Now _Subsurface_ knows exactly
-when the photograph has been taken. Now set the date-time dialog to the left of the photo
-so that this tool reflects the date and time of the dive computer in the photo. When the
-date-time tool has been set, _Subsurface_ knows exactly what the time difference between
-camera and dive computer is, and synchronisation is achieved. There is a
-photograph with the face of the dive computer and with the date-time tool set to the
-date-time on image *B* above.
+ photograph of the face of the dive computer showing the time, then _Subsurface_ can obtain
+ the exact time the photograph was taken, using the metadata that the camera stores within
+ each photo. In order to do this, use the bottom half of the Time shift_ dialog. If one uses
+ the bottom part, the top part of the dialog is ignored. Click on
+ the horizontal bar entitled "_Select image of divecomputer showing time_. This brings up
+ a file browser with which one can select the photograph of the dive computer. Select the
+ photograph using the file browser and click on _OK_. This photograph of the dive computer
+ appears in the bottom panel of the _Shift times_ dialog. Now _Subsurface_ knows exactly
+ when the photograph has been taken. Now set the date-time dialog to the left of the photo
+ so that this tool reflects the date and time of the dive computer in the photo. When the
+ date-time tool has been set, _Subsurface_ knows exactly what the time difference between
+ camera and dive computer is, and synchronisation is achieved. There is a
+ photograph with the face of the dive computer and with the date-time tool set to the
+ date-time on image *B* above.
If the timestamp of a photograph is long before or after the dive, it is not placed on
the dive profile. If the timestamp of the photo is within 30 minutes of the dive, it is shown.
@@ -1667,26 +1667,26 @@ _Subsurface_ easily handles dives involving more than one cylinder. Sidemount di
three steps:
- *During the dive, recording cylinder switch events*. Since sidemount diving normally involves two
-cylinders with air or with the same gas mixture, _Subsurface_ distinguishes among these different
-cylinders. In contrast, most dive computers that allow gas switching only distinguish among different
-_gases_ used, not among different _cylinders_ used. This means that when sidemount dives are downloaded
-from these dive computers, the events of switching between cylinders with the same gas are not downloaded. This may mean
-that one may have to keep a written log of cylinder switch times using a slate, or (if the dive computer
-has this facility) marking each cylinder switch with a bookmark that can be retrieved later. Returning
-from a dive with the information about cylinder changes is the only tricky part of logging sidemount dives.
+ cylinders with air or with the same gas mixture, _Subsurface_ distinguishes among these different
+ cylinders. In contrast, most dive computers that allow gas switching only distinguish among different
+ _gases_ used, not among different _cylinders_ used. This means that when sidemount dives are downloaded
+ from these dive computers, the events of switching between cylinders with the same gas are not downloaded. This may mean
+ that one may have to keep a written log of cylinder switch times using a slate, or (if the dive computer
+ has this facility) marking each cylinder switch with a bookmark that can be retrieved later. Returning
+ from a dive with the information about cylinder changes is the only tricky part of logging sidemount dives.
- *Within _Subsurface_ describe the cylinders used during the dive*. The diver needs to provide the
-specifications of the different cylinders, using the *Equipment* tab of the *Dive Info Panel* (see
-image below where two 12 litre cylinder were used).
+ specifications of the different cylinders, using the *Equipment* tab of the *Dive Info Panel* (see
+ image below where two 12 litre cylinder were used).
- *Indicate cylinder change events on the _Subsurface_ dive profile*. Once the dive log has been imported
-from a dive computer into _Subsurface_, the cylinder switch events need to be indicated on the dive profile.
-Cylinder changes are recorded by right-clicking at the appropriate point on the dive profile and then
-selecting _Add gas change_. A list of the appropriate cylinders is shown with the
-currently used cylinder greyed out. In the image below Tank 1 is greyed out, leaving only Tank 2
-to be selected. Select the appropriate cylinder. The cylinder change is then indicated on the dive
-profile with a cylinder symbol. If the *Tank Bar* is activated using the toolbar to the left of the
-profile, then the cylinder change is also indicated on the Tank Bar (see image below). After all
-the cylinder change events have been recorded on the dive profile, the correct cylinder pressures
-for both cylinders are shown on the dive profile, as inthe image below.
+ from a dive computer into _Subsurface_, the cylinder switch events need to be indicated on the dive profile.
+ Cylinder changes are recorded by right-clicking at the appropriate point on the dive profile and then
+ selecting _Add gas change_. A list of the appropriate cylinders is shown with the
+ currently used cylinder greyed out. In the image below Tank 1 is greyed out, leaving only Tank 2
+ to be selected. Select the appropriate cylinder. The cylinder change is then indicated on the dive
+ profile with a cylinder symbol. If the *Tank Bar* is activated using the toolbar to the left of the
+ profile, then the cylinder change is also indicated on the Tank Bar (see image below). After all
+ the cylinder change events have been recorded on the dive profile, the correct cylinder pressures
+ for both cylinders are shown on the dive profile, as inthe image below.
image::images/sidemount1.jpg["FIGURE: Sidemount profile",align="center"]
@@ -2029,53 +2029,53 @@ meaning of the different parts of the Gas Pressure Bar Graph.
image::images/GasPressureBarGraph.jpg["FIGURE:Gas Pressure bar Graph",align="center"]
- The light green area indicates the total gas, with the top margin of the light green
-area indicating the total gas pressure inhaled by the diver and measured from the bottom
-of the graph to the top of the light green area. This pressure has a _relative_ value in the graph
-and does not indicate absolute pressure.
+ area indicating the total gas pressure inhaled by the diver and measured from the bottom
+ of the graph to the top of the light green area. This pressure has a _relative_ value in the graph
+ and does not indicate absolute pressure.
- The horizontal black line underneath the light green margin indicates the equilibrium pressure
-of the inert gases inhaled by the diver, usually nitrogen. In
-the case of trimix, it is the pressures of nitrogen and helium combined. In this example,
-the user is diving with EAN32, so the inert gas pressure is 68% of the distance from the
-bottom of the graph to the total gas pressure value.
+ of the inert gases inhaled by the diver, usually nitrogen. In
+ the case of trimix, it is the pressures of nitrogen and helium combined. In this example,
+ the user is diving with EAN32, so the inert gas pressure is 68% of the distance from the
+ bottom of the graph to the total gas pressure value.
- The dark green area at the bottom of the graph represents the pressures of inert gas in each
-of the 16 tissue compartments, following the Bühlmann algorithm, the fast tissues being on the
-left hand side.
+ of the 16 tissue compartments, following the Bühlmann algorithm, the fast tissues being on the
+ left hand side.
- The top black horizontal line indicates the gradient factor that applies to the depth of
-the diver at the particular point on the *Dive Profile*. The appropriate gradient factor is an
-interpolation between the FGLow and GFHigh values specified in the Graph tab of the *Preferences
-Panel* of *Subsurface*.
+ the diver at the particular point on the *Dive Profile*. The appropriate gradient factor is an
+ interpolation between the FGLow and GFHigh values specified in the Graph tab of the *Preferences
+ Panel* of *Subsurface*.
- The bottom margin of the red area in the graph indicates the Bühlman-derived M-value, that is the
-pressure value of inert gases at which bubble formation is expected to be severe, resulting
-in decompression sickness.
+ pressure value of inert gases at which bubble formation is expected to be severe, resulting
+ in decompression sickness.
These five values are indicated on the left in the graph above. The way the Gas Pressure Bar Graph changes
during a dive is indicated on the right hand side of the above figure for a diver using EAN32.
- Graph *A* indicates the situation at the start of a dive with diver at the surface. The pressures in all
-the tissue compartments are still at the equilibrium pressure because no diving has taken place.
+ the tissue compartments are still at the equilibrium pressure because no diving has taken place.
- Graph *B* indicates the situation after a descent to 30 meters. Few of the tissue compartments have had
-time to respond to the descent, their gas pressures being far below the equilibrium gas pressure.
+ time to respond to the descent, their gas pressures being far below the equilibrium gas pressure.
- Graph *C* represents the pressures after 30 minutes at 30 m. The fast compartments have attained
-equilibrium (i.e. they have reached the hight of the black line indicating the equilibrium pressure). The
-slower compartments (towards the right) have not reached equilibrium and are in the process of slowly
-increasing in pressure.
+ equilibrium (i.e. they have reached the hight of the black line indicating the equilibrium pressure). The
+ slower compartments (towards the right) have not reached equilibrium and are in the process of slowly
+ increasing in pressure.
- Graph *D* shows the pressures after ascent to a depth of 4.5 meters. Since, during ascent, the total
-inhaled gas pressure has decreased strongly from 4 bar to 1.45 bar, the pressures in the different tissue
-compartments now exceed that of the total gas pressure and approaches the gradient factor value (i.e.
-the top black horizontal line). Further ascent will result in exceeding the gradient
-factor value (GFHigh), endangering the diver.
+ inhaled gas pressure has decreased strongly from 4 bar to 1.45 bar, the pressures in the different tissue
+ compartments now exceed that of the total gas pressure and approaches the gradient factor value (i.e.
+ the top black horizontal line). Further ascent will result in exceeding the gradient
+ factor value (GFHigh), endangering the diver.
- Graph *E* indicates the situation after remaining at 4.5 meters for 10 minutes. The fast compartments
-have decreased in pressure. As expected, the pressures in the slow compartments have not changed much.
-The pressures in the fast compartments do not approach the GFHigh value any more and the diver is safer
-than in the situation indicated in graph *D*.
+ have decreased in pressure. As expected, the pressures in the slow compartments have not changed much.
+ The pressures in the fast compartments do not approach the GFHigh value any more and the diver is safer
+ than in the situation indicated in graph *D*.
@@ -2289,40 +2289,40 @@ A dive log or part of it can be saved in three formats:
* _Subsurface XML_ format. This is the native format used by _Subsurface_.
* Universal Dive Data Format (_UDDF_). Refer to _http://uddf.org_ for more information.
-UDDF is a generic format that enables communication among many dive computers
-and computer programs.
+ UDDF is a generic format that enables communication among many dive computers
+ and computer programs.
* _Divelogs.de_, an Internet-based dive log repository. In order to upload to _Divelogs.de_,
-one needs a user-ID as well as a password for _Divelogs.de_. Log into _http://en.divelogs.de_
-and subscribe to this service in order to upload dive log data from _Subsurface_.
+ one needs a user-ID as well as a password for _Divelogs.de_. Log into _http://en.divelogs.de_
+ and subscribe to this service in order to upload dive log data from _Subsurface_.
* _CSV_ format, that includes the most critical information of the dive
-profile. Included information of a dive is: dive number, date, time,
-duration, depth, temperature and pressure.
+ profile. Included information of a dive is: dive number, date, time,
+ duration, depth, temperature and pressure.
* _Worldmap_ format, an HTML file with a world map upon which each dive and
-some information about it are indicated. This map is not editable.
+ some information about it are indicated. This map is not editable.
* _HTML_ format, in which the dive(s) are stored in HTML files, readable
-with an Internet browser. Most modern web browsers are supported, but JavaScript
-must be enabled. This generated HTML file is not intended to be edited
-by the users.
-The HTML dive log contains most of the information and also contains a search
-option to search the dive log. HTML export is specified on the second tab of the
-Export dialog (image *B* above).
+ with an Internet browser. Most modern web browsers are supported, but JavaScript
+ must be enabled. This generated HTML file is not intended to be edited
+ by the users.
+ The HTML dive log contains most of the information and also contains a search
+ option to search the dive log. HTML export is specified on the second tab of the
+ Export dialog (image *B* above).
* _General Settings_, under the HTML tab, provides the following options:
** Subsurface Numbers: if this option is checked, the dive(s) are exported with the
-numbers associated with them in Subsurface, Otherwise the dive(s) will be numbered
-starting from 1.
+ numbers associated with them in Subsurface, Otherwise the dive(s) will be numbered
+ starting from 1.
** Export Yearly Statistics: if this option is checked, a yearly statistics table will
-be attached with the HTML exports.
+ be attached with the HTML exports.
** Export List only: a list of dives will only be exported and the detailed dive
-information will not be available.
+ information will not be available.
* Under _Style Options_ some style-related options are available like font
-size and theme.
+ size and theme.
Export to other formats can be achieved through third party facilities, for
instance _www.divelogs.de_.
@@ -2383,9 +2383,9 @@ few selected dives, including dive profiles and other contextual information.
Before printing, two decisions are required:
- Should the whole dive log be printed or only part of it? If only part of the
-dive log is required, then the user must select the required dives from the *Dive List* panel.
+ dive log is required, then the user must select the required dives from the *Dive List* panel.
- What gas partial pressure information is required on the dive profile? Users should select
-the appropriate toggle-buttons on the button bar to the left of the Dive Profile panel.
+ the appropriate toggle-buttons on the button bar to the left of the Dive Profile panel.
Now the print options should be selected to match the user's needs. To do this, user should select _File->Print_ from
the Main menu. The following dialogue appears (see the image on the left [A],
@@ -2397,17 +2397,17 @@ Under _Print type_ users need to select one of three options:
- Print the complete Dive List: to do this, _Table Print_ should be selected.
- Print the selected dives (dive profiles and all other information) at 6
-dives per printed page: to do this, users should select _6 dives per page_.
+ dives per printed page: to do this, users should select _6 dives per page_.
- Print the selected dives (dive profiles and all other information) at 2
-dives per printed page: to do this, users should select _2 dives per page_.
+ dives per printed page: to do this, users should select _2 dives per page_.
- Print the selected dives (dive profiles and all other information) at 1
-dive per printed page: to do this, users should select _1 dive per page_.
+ dive per printed page: to do this, users should select _1 dive per page_.
Under _Print options_ users need to select:
- Printing only the dives that have been selected from the dive list prior to
-activating the print dialogue, achieved by checking the box _Print only
-selected dives_.
+ activating the print dialogue, achieved by checking the box _Print only
+ selected dives_.
- Printing in colour, achieved by checking the box with _Print in colour_.
The _Ordering_ affects the layout of the page (or part of it) for each dive.
@@ -2451,36 +2451,36 @@ There are several settings in the *Defaults* panel:
image::images/Pref1.jpg["FIGURE: Preferences defaults page",align="center"]
** *Lists and tables*: Here one can specify the font type and font size of the
-*Dive Table* panel. By decreasing the font size of the *Dive Table*, users can see more dives on a screen.
+ *Dive Table* panel. By decreasing the font size of the *Dive Table*, users can see more dives on a screen.
** *Dives*: For the _Default Dive File_ one need to specify the directory and
-file name of one's
-electronic dive log book. This is a file with filename extension .xml. When
-launched, _Subsurface_ will automatically load the specified dive log book.
+ file name of one's
+ electronic dive log book. This is a file with filename extension .xml. When
+ launched, _Subsurface_ will automatically load the specified dive log book.
** *Display invalid*: Dives can be marked as invalid (when a user wishes to hide
-dives that he/she don't consider valid dives, e.g. pool dives, but still want to
-keep them in the dive log). This controls whether those dives are displayed in
-the dive list.
+ dives that he/she don't consider valid dives, e.g. pool dives, but still want to
+ keep them in the dive log). This controls whether those dives are displayed in
+ the dive list.
** *Default cylinder*: Here users can specify the default cylinder listed in
-the *Equipment* tab of the *Dive Notes* panel.
+ the *Equipment* tab of the *Dive Notes* panel.
** *Animations*: Some actions in showing the dive profile are performed using
-animations. For instance, the axis values for depth and time change from dive to
-dive. When viewing a different dive, these changes in axis characteristics do not
-happen instantaneously, but are animated. The _Speed_ of animations can be controlled
-by setting this slider
-with faster animation speed to the left, with a 0 value representing no animation
-at all.
+ animations. For instance, the axis values for depth and time change from dive to
+ dive. When viewing a different dive, these changes in axis characteristics do not
+ happen instantaneously, but are animated. The _Speed_ of animations can be controlled
+ by setting this slider
+ with faster animation speed to the left, with a 0 value representing no animation
+ at all.
- ** *Subsurface web service*: When one subscribes to the <<S_Companion,Subsurface web service>>, a very
-long and hard-to-remember userID is issued. This is the place to save that userID. By
-checking the option _Save User ID locally?_, one ensures that a local copy of that userID
-is saved.
+ ** *Subsurface web service*: When one subscribes to the <<S_Companion,Subsurface web service>>, a very
+ long and hard-to-remember userID is issued. This is the place to save that userID. By
+ checking the option _Save User ID locally?_, one ensures that a local copy of that userID
+ is saved.
- ** *Clear all settings*: As indicated in the button below this heading, all settings are
-cleared and set to default values.
+ ** *Clear all settings*: As indicated in the button below this heading, all settings are
+ cleared and set to default values.
=== Units
image::images/Pref2.jpg["FIGURE: Preferences Units page",align="center"]
@@ -2498,36 +2498,36 @@ image::images/Pref3.jpg["FIGURE: Preferences Graph page",align="center"]
This panel allows two type of selections:
* *Show*: Here users can specify the amount of information shown as part of
-the dive profile:
+ the dive profile:
** Thresholds: _Subsurface_ can display the nitrogen, oxygen and the helium partial pressures during
-the dive. These are enabled 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 this threshold level, the graph is
-highlighted in red, indicating that the threshold has been exceeded.
+ the dive. These are enabled 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 this threshold level, the graph is
+ highlighted in red, indicating that the threshold has been exceeded.
** _Draw dive computer reported ceiling red_: This checkbox allows exactly what it says.
-Not all dive computers report ceiling values. If the dive computer does report it, it may differ
-from the ceilings calculated by _Subsurface_. This is because of the different algorithms and gradient factors available for calculating ceilings, as well as the dynamic way that a
-dive computer can calculate ceilings during a dive.
+ Not all dive computers report ceiling values. If the dive computer does report it, it may differ
+ from the ceilings calculated by _Subsurface_. This is because of the different algorithms and gradient factors available for calculating ceilings, as well as the dynamic way that a
+ dive computer can calculate ceilings during a dive.
** _Show unused cylinders in Equipment Tab_: This checkbox allows display of information about unused cylinders when viewing the *Equipment Tab*. Conversely, if this box is not checked, and any cylinders entered using the *Equipment Tab* are not used (e.g. there was no gas switch to such a cylinder), then these cylinders are omitted from that list.
** _Show average depth_: Activating this checkbox causes _Subsurface_ to draw a red line across
-the dive profile, indicating the mean depth of the dive.
+ the dive profile, indicating the mean depth of the dive.
* *Misc*:
** Gradient Factors:* Here users can set the _gradient factors_ used while diving. GF_Low is
-the gradient factor at depth and GF_High is used just below the surface.
-At intermediate depths gradient factors between GF_Low and GF_High are used.
-Gradient factors add conservatism to the nitrogen exposure during a dive, in a
-similar way that many dive computers have a conservatism setting. The lower
-the value of a gradient factor, the more conservative the calculations are with
-respect to nitrogen loading and the deeper the ascent ceilings are. Gradient
-factors of 20/60 are considered conservative and values of 60/90 are considered
-harsh. Checking *GFLow at max depth* box causes GF_Low to be used at the
-deepest depth of a dive. If this box is not checked, GF_Low is applied at
-all depths deeper than the first deco stop. For more information see:
+ the gradient factor at depth and GF_High is used just below the surface.
+ At intermediate depths gradient factors between GF_Low and GF_High are used.
+ Gradient factors add conservatism to the nitrogen exposure during a dive, in a
+ similar way that many dive computers have a conservatism setting. The lower
+ the value of a gradient factor, the more conservative the calculations are with
+ respect to nitrogen loading and the deeper the ascent ceilings are. Gradient
+ factors of 20/60 are considered conservative and values of 60/90 are considered
+ harsh. Checking *GFLow at max depth* box causes GF_Low to be used at the
+ deepest depth of a dive. If this box is not checked, GF_Low is applied at
+ all depths deeper than the first deco stop. For more information see:
** http://www.tek-dive.com/portal/upload/M-Values.pdf[Understanding M-values by Erik Baker, _Immersed_ Vol. 3, No. 3.]
@@ -2579,15 +2579,15 @@ and assumes the user is already familiar with the _Subsurface_
user interface. It is explicitly used under the following conditions:
- The user is conversant with dive planning and has the necessary training to perform
-dive planning.
+ dive planning.
- The user plans dives within his/her certification limits.
- Dive planning makes large assumptions about the characteristics of the _average person_
-and cannot compensate for individual physiology or health or personal history or
-life style characteristics.
+ and cannot compensate for individual physiology or health or personal history or
+ life style characteristics.
- The safety of a dive plan depends heavily on the way in which the planner is used.
- The user is familiar with the user interface of _Subsurface_.
- A user who is not absolutely sure about any of the above requirements should not use
-this feature.
+ this feature.
****
=== The _Subsurface_ dive planner screen
@@ -2613,25 +2613,25 @@ The dive planner comprises two parts: *constructing a dive plan* and *evaluating
that dive plan. To perform dive planning, perform these steps:
- Clear the existing dive log by creating a new planning log. This is achieved by selecting
-_File -> New logbook_ from the main menu. This way, dive plans are kept separate
-from the existing dive log of completed dives.
+ _File -> New logbook_ from the main menu. This way, dive plans are kept separate
+ from the existing dive log of completed dives.
- In the top left-hand area of the screen, ensure that the constant dive parameters are
-appropriate. These are: Start date and time of the dive, Atmospheric Pressure and Altitude
-above sea level of the dive site. The atmospheric pressure can also be entered as an altitude
-in metres, assuming an atmospheric pressure of 1.013 bar.
+ appropriate. These are: Start date and time of the dive, Atmospheric Pressure and Altitude
+ above sea level of the dive site. The atmospheric pressure can also be entered as an altitude
+ in metres, assuming an atmospheric pressure of 1.013 bar.
- In the table labelled _Available Gases_, 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
-<<S_CylinderData,providing cylinder data for dive logs>>. 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%) filed empty,
-the dive gas is assumed to be 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.
+ as well as the gas composition within that cylinder. This is done in a similar way as for
+ <<S_CylinderData,providing cylinder data for dive logs>>. 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%) filed empty,
+ the dive gas is assumed to be 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.
- The dialogue indicating _Dive Planner Points_ is usually not used at this stage of the dive
-planning.
+ planning.
=== Managing nitrogen, oxygen and gas consumption
@@ -2838,14 +2838,14 @@ dealing with the appropriate operations.
=== File
- <<S_NewLogbook,_New Logbook_>> - Close the currently open dive logbook and
-clear all dive information.
+ clear all dive information.
- _Open logbook_ - This opens the file manager in order to select a dive
-logbook to open.
+ logbook to open.
- _Save_ - Save the dive logbook that is currently open.
- _Save as_ - Save the current logbook under a different file name.
- _Close_ - Close the dive logbook that is currently open.
- <<S_ExportLog,_Export_>> - Export the currently open dive logbook (or
-the selected dives in the logbook) to one of several formats.
+ the selected dives in the logbook) to one of several formats.
- <<S_PrintDivelog,_Print_>> - Print the currently open logbook.
- <<S_Preferences,_Preferences_>> - Set the _Subsurface_ preferences.
- <<S_Configure,_Configure dive computer_>> - Edit the configuration of a dive computer.
@@ -2853,13 +2853,13 @@ the selected dives in the logbook) to one of several formats.
=== Import
- <<S_ImportDiveComputer,_Import from dive computer_>> - Import dive information
-from a dive computer.
+ from a dive computer.
- <<Unified_import,_Import Log Files_>> - Import dive information from a file in
-in a _Subsurface_-compatible format.
+ in a _Subsurface_-compatible format.
- <<S_Companion,_Import GPS data from Subsurface web service_>> - Load GPS
-coordinates from the _Subsurface_ mobile phone app.
+ coordinates from the _Subsurface_ mobile phone app.
- <<S_ImportingDivelogsDe,_Import from Divelogs.de_>> - Import dive information
-from _www.Divelogs.de_.
+ from _www.Divelogs.de_.
=== Log
- <<S_EnterData,_Add Dive_>> - Manually add a new dive to the *Dive List* panel.
@@ -2868,32 +2868,32 @@ from _www.Divelogs.de_.
- <<S_CopyComponents,_Copy dive components_>> - By selecting this option, one can copy information
from several fields of a dive log onto the clipboard.
- _Paste dive components_ - Paste, into the selected dives in the *Dive List*,
- the information copied using the _Copy dive components_ option.
+ the information copied using the _Copy dive components_ option.
- <<S_Renumber,_Renumber_>> - Renumber the dives listed in the *Dive List*
-panel.
+ panel.
- <<S_Group,_Auto Group_>> - Group the dives in the *Dive List* panel into dive
-trips.
+ trips.
- <<S_DeviceNames,_Edit Device Names_>> - Edit the names of dive computers to facilitate your logs.
- <<S_Filter,_Filter divelist_>> - Select only some dives, based on specific tags or dive criteria.
=== View
- <<S_ViewPanels,_All_>> - View the four main _Subsurface_ panels
-simmultaneously.
+ simmultaneously.
- <<S_ViewPanels,_Dive List_>> - View only the *Dive List* panel.
- <<S_ViewPanels,_Profile_>> - View only the *Dive Profile* panel.
- <<S_ViewPanels,_Info_>> - View only the *Dive Notes* panel.
- <<S_ViewPanels,_Globe_>> - View only the *World Map* panel.
- _Yearly Statistics_ - Display summary statistics about dives during this and past
-years.
+ years.
- _Prev DC_ - Switch to previous dive computer.
- _Next DC_ - Switch to next dive computer.
- _Full Screen_ - Toggles Full Screen mode.
=== Help
- _About Subsurface_ - Show a panel with the version number of _Subsurface_ as
-well as licensing information.
+ well as licensing information.
- _Check for updates_ - Find out whether a newer version of Subsurface is available
-on the http://subsurface-divelog.org/[_Subsurface_ web site].
+ on the http://subsurface-divelog.org/[_Subsurface_ web site].
- _User Manual_ - Open a window showing this user manual.
@@ -3061,26 +3061,26 @@ enable it, in case of +initd+, run something like +rc.config start bluetoothd+ o
One may also use a manual approach by using such commands:
* +hciconfig+ shows the Bluetooth devices available on your
-computer (not dive computer), most likely one will see a hci0, if not
-try +hcitool -a+ to see inactive devices and run +sudo
-hciconfig hci0 up+ to bring them up.
+ computer (not dive computer), most likely one will see a hci0, if not
+ try +hcitool -a+ to see inactive devices and run +sudo
+ hciconfig hci0 up+ to bring them up.
* +hcitool scanning+ gets a list of bluetooth enabled
-client devices, look for the dive computer and remember the MAC
-address are shown there
+ client devices, look for the dive computer and remember the MAC
+ address are shown there
* +bluez-simple-agent hci0 10:00:E8:C4:BE:C4+ pairs
-the dive computer with the bluetooth stack of the _Subsurface_ computer, copy/paste
-the MAC address from the output of 'hcitool scanning'
+ the dive computer with the bluetooth stack of the _Subsurface_ computer, copy/paste
+ the MAC address from the output of 'hcitool scanning'
Unfortunately on Linux binding to a communication device has to be done
manually by running:
* +rfcomm bind /dev/rfcomm0 10:00:E8:C4:BE:C4+ binds the dive
-computer to a communication device in the desktop computer, in case rfcomm is
-already taken use rfcomm1 or up. IMPORTANT: Copy/paste the MAC address
-from the output of +hcitool scanning+, the MAC address shown above will not
-work.
+ computer to a communication device in the desktop computer, in case rfcomm is
+ already taken use rfcomm1 or up. IMPORTANT: Copy/paste the MAC address
+ from the output of +hcitool scanning+, the MAC address shown above will not
+ work.
For downloading dives in _Subsurface_ specify the device name connected to the MAC
address in the last step above, e.g. _/dev/rfcomm0_.
@@ -3195,10 +3195,10 @@ desktop computer utilises the IrDA infra-red protocol. Only data for one dive
can be downloaded at a time, comprising three files:
- Setup configuration for the dive and key dive parameters (file with a .txt
-extension)
+ extension)
- Dive log details (file with a .csv extension)
- Redbook format dive log (file with .cvsr extension). This is a compressed
-version of the dive log using a proprietary format.
+ version of the dive log using a proprietary format.
_Subsurface_ accesses the .txt and the .csv files to obtain dive log information.
@@ -3219,13 +3219,13 @@ APD inspiration dive logs are imported into _Subsurface_ as follows:
- If the raw dive log data show on the screen, click on "_Copy to Clipboard_".
- Open a text editor, e.g. Notepad (Windows), TextWrangler (Mac).
- Copy the contents of the clipboard into the text editor and save the text file
-with a filename extension of .CSV
+ with a filename extension of .CSV
- Within _Subsurface_, select _Import->Import log files_ to open the xref:Unified_import[universal import dialogue].
- In the dropdown list towards the bottom right of the dialogue, select "_CSV files_".
- On the list of file names select the .CSV file that has been created above. An import
-dialogue opens.
+ dialogue opens.
- In the dropdown list on the middle right labeled '_Pre-configured imports_",
-select _APD Log Viewer_.
+ select _APD Log Viewer_.
- Ensure the other settings for the ADP dive log are appropriate, then select _OK_.
The APD dive log will appear within _Subsurface_.
@@ -3242,7 +3242,7 @@ xref:Unified_import[here.]
However, in some cases, a two-step process may be required:
1. Export the foreign dive log data to format that is accessible from
-_Subsurface_.
+ _Subsurface_.
2. Import the accessible dive log data into _Subsurface_.
This appendix provides some information about approaches to export dive log
@@ -3264,18 +3264,17 @@ conventions to export dive log data.
1. Start 'Suunto Divemanager 3' and log in with the name containing the logs
2. Do not start the import wizard to import dives from the dive computer.
3. In the navigation tree on the left side of the program-window, select the appropriate
-dives.
+ dives.
4. Within the list of dives, select the dives you would like to import later:
* To select certain dives: hold 'ctrl' and click the dive
* To select all dives: Select the first dive, hold down shift and
-select the
-last dive
+ select the last dive
5. With the dives marked, use the program menu _File -> Export_
6. The export pop-up will show. Within this pop-up, there is one field called 'Export Path'.
* Click the browse button next to the field Export Path
** A file-manager like window pops up
** Navigate to the directory for storing the
-Divelog.SDE file
+ Divelog.SDE file
** Optionally change the name of the file for saving
** Click 'Save'
* Back in the Export pop-up, press the button 'Export'
@@ -3320,12 +3319,12 @@ of the dive database is to export the information to another compatible format
which can be imported into _Subsurface_.
1. Within Dive Organiser, select
-_Database -> Backup_ from the main menu and back up the database to the desk
-top.
-This creates a zipped file DiveOrganiserxxxxx.dbf.
+ _Database -> Backup_ from the main menu and back up the database to the desk
+ top.
+ This creates a zipped file DiveOrganiserxxxxx.dbf.
2. Rename the file to
-DiveOrganiserxxxxx.zip. Inside the zipped directory is a file
-_DiveOrganiser.sdf_.
+ DiveOrganiserxxxxx.zip. Inside the zipped directory is a file
+ _DiveOrganiser.sdf_.
3. Extract the _.sdf_ file from the zipped folder to your Desktop.
4. The password for accessing the .zip file is _mares_.
@@ -3397,8 +3396,8 @@ One can change the character back to the default character by following the same
- In Microsoft Windows, click the *Start* button, and then select _Control Panel_ from the list on the right-hand side.
- Open the _Regional and Language Options_ dialog box.
- Do one of the following:
-** In Windows 7, click the _Formats_ tab, and then click _Customize this format_.
-** In Windows XP, click the _Regional Options_ tab, and then click _Customize_.
+ ** In Windows 7, click the _Formats_ tab, and then click _Customize this format_.
+ ** In Windows XP, click the _Regional Options_ tab, and then click _Customize_.
- Type a new separator in the _List separator_ box. To use a TAB-delimited file, type the word TAB in the box.
- Click _OK_ twice.
--
1.8.4.5
More information about the subsurface
mailing list