From dffd2857f62ccbdb9a1329c4915717dbc60e0909 Mon Sep 17 00:00:00 2001 From: Willem Ferguson Date: Mon, 19 Oct 2015 17:45:53 +0200 Subject: User manual updates 1) Delete duplicate or unused images in Documentation/images directory 2) Add text to describe user manual viewer functionality 3) Add image to explain 2) above 4) Add text to explanation of TTS toolbar button (Thank you very much, Davide!) 5) Update image showing display of TTS toolbar button Signed-off-by: Willem Ferguson Signed-off-by: Dirk Hohndel --- Documentation/images/AddDive1_f20.jpg | Bin 51311 -> 0 bytes Documentation/images/AddDive2_f20.jpg | Bin 21776 -> 0 bytes Documentation/images/AddDive2_f22.jpg | Bin 38723 -> 0 bytes Documentation/images/AddDive3_f20.jpg | Bin 18888 -> 0 bytes Documentation/images/BlueEditBar_f20.jpg | Bin 5925 -> 0 bytes Documentation/images/CCR_dive_profile_f20.jpg | Bin 37398 -> 0 bytes Documentation/images/Ceilings.png | Bin 31673 -> 0 bytes Documentation/images/CompletedDiveInfo_f20.jpg | Bin 31040 -> 0 bytes Documentation/images/DiveProfile4_f20.jpg | Bin 25220 -> 0 bytes Documentation/images/Gas_dialogue1_f20.jpg | Bin 7380 -> 0 bytes Documentation/images/Gas_dialogue2_f20.jpg | Bin 7847 -> 0 bytes Documentation/images/ImportFromDC1_f20.jpg | Bin 29489 -> 0 bytes Documentation/images/InfoBox2.jpg | Bin 67631 -> 85500 bytes Documentation/images/PrintDiveLog.jpg | Bin 33884 -> 0 bytes Documentation/images/Print_stats_f22.jpg | Bin 24375 -> 0 bytes Documentation/images/Subsurface4Banner.png | Bin 257234 -> 0 bytes Documentation/images/field_options.jpg | Bin 67741 -> 0 bytes Documentation/images/main_window_f20.jpg | Bin 92735 -> 0 bytes Documentation/images/tissues.jpg | Bin 1270 -> 0 bytes Documentation/images/usermanualfunctions.jpg | Bin 0 -> 15543 bytes Documentation/user-manual.txt | 35 ++++++++++++++++++++----- 21 files changed, 28 insertions(+), 7 deletions(-) delete mode 100644 Documentation/images/AddDive1_f20.jpg delete mode 100644 Documentation/images/AddDive2_f20.jpg delete mode 100644 Documentation/images/AddDive2_f22.jpg delete mode 100644 Documentation/images/AddDive3_f20.jpg delete mode 100644 Documentation/images/BlueEditBar_f20.jpg delete mode 100644 Documentation/images/CCR_dive_profile_f20.jpg delete mode 100644 Documentation/images/Ceilings.png delete mode 100644 Documentation/images/CompletedDiveInfo_f20.jpg delete mode 100644 Documentation/images/DiveProfile4_f20.jpg delete mode 100644 Documentation/images/Gas_dialogue1_f20.jpg delete mode 100644 Documentation/images/Gas_dialogue2_f20.jpg delete mode 100644 Documentation/images/ImportFromDC1_f20.jpg delete mode 100644 Documentation/images/PrintDiveLog.jpg delete mode 100644 Documentation/images/Print_stats_f22.jpg delete mode 100644 Documentation/images/Subsurface4Banner.png delete mode 100644 Documentation/images/field_options.jpg delete mode 100644 Documentation/images/main_window_f20.jpg delete mode 100644 Documentation/images/tissues.jpg create mode 100644 Documentation/images/usermanualfunctions.jpg diff --git a/Documentation/images/AddDive1_f20.jpg b/Documentation/images/AddDive1_f20.jpg deleted file mode 100644 index 414795d6d..000000000 Binary files a/Documentation/images/AddDive1_f20.jpg and /dev/null differ diff --git a/Documentation/images/AddDive2_f20.jpg b/Documentation/images/AddDive2_f20.jpg deleted file mode 100644 index 4e65dac94..000000000 Binary files a/Documentation/images/AddDive2_f20.jpg and /dev/null differ diff --git a/Documentation/images/AddDive2_f22.jpg b/Documentation/images/AddDive2_f22.jpg deleted file mode 100644 index a19e24b7e..000000000 Binary files a/Documentation/images/AddDive2_f22.jpg and /dev/null differ diff --git a/Documentation/images/AddDive3_f20.jpg b/Documentation/images/AddDive3_f20.jpg deleted file mode 100644 index 790458345..000000000 Binary files a/Documentation/images/AddDive3_f20.jpg and /dev/null differ diff --git a/Documentation/images/BlueEditBar_f20.jpg b/Documentation/images/BlueEditBar_f20.jpg deleted file mode 100644 index 5b9ab2a97..000000000 Binary files a/Documentation/images/BlueEditBar_f20.jpg and /dev/null differ diff --git a/Documentation/images/CCR_dive_profile_f20.jpg b/Documentation/images/CCR_dive_profile_f20.jpg deleted file mode 100644 index fd0f23990..000000000 Binary files a/Documentation/images/CCR_dive_profile_f20.jpg and /dev/null differ diff --git a/Documentation/images/Ceilings.png b/Documentation/images/Ceilings.png deleted file mode 100644 index 55e53abf1..000000000 Binary files a/Documentation/images/Ceilings.png and /dev/null differ diff --git a/Documentation/images/CompletedDiveInfo_f20.jpg b/Documentation/images/CompletedDiveInfo_f20.jpg deleted file mode 100644 index d173febcd..000000000 Binary files a/Documentation/images/CompletedDiveInfo_f20.jpg and /dev/null differ diff --git a/Documentation/images/DiveProfile4_f20.jpg b/Documentation/images/DiveProfile4_f20.jpg deleted file mode 100644 index 9df2b9a55..000000000 Binary files a/Documentation/images/DiveProfile4_f20.jpg and /dev/null differ diff --git a/Documentation/images/Gas_dialogue1_f20.jpg b/Documentation/images/Gas_dialogue1_f20.jpg deleted file mode 100644 index 4e304a200..000000000 Binary files a/Documentation/images/Gas_dialogue1_f20.jpg and /dev/null differ diff --git a/Documentation/images/Gas_dialogue2_f20.jpg b/Documentation/images/Gas_dialogue2_f20.jpg deleted file mode 100644 index 098ea3266..000000000 Binary files a/Documentation/images/Gas_dialogue2_f20.jpg and /dev/null differ diff --git a/Documentation/images/ImportFromDC1_f20.jpg b/Documentation/images/ImportFromDC1_f20.jpg deleted file mode 100644 index a38a33cf8..000000000 Binary files a/Documentation/images/ImportFromDC1_f20.jpg and /dev/null differ diff --git a/Documentation/images/InfoBox2.jpg b/Documentation/images/InfoBox2.jpg index 5b443fa37..64c843289 100644 Binary files a/Documentation/images/InfoBox2.jpg and b/Documentation/images/InfoBox2.jpg differ diff --git a/Documentation/images/PrintDiveLog.jpg b/Documentation/images/PrintDiveLog.jpg deleted file mode 100644 index 8ff972dd7..000000000 Binary files a/Documentation/images/PrintDiveLog.jpg and /dev/null differ diff --git a/Documentation/images/Print_stats_f22.jpg b/Documentation/images/Print_stats_f22.jpg deleted file mode 100644 index 1f75b78f6..000000000 Binary files a/Documentation/images/Print_stats_f22.jpg and /dev/null differ diff --git a/Documentation/images/Subsurface4Banner.png b/Documentation/images/Subsurface4Banner.png deleted file mode 100644 index ce0743130..000000000 Binary files a/Documentation/images/Subsurface4Banner.png and /dev/null differ diff --git a/Documentation/images/field_options.jpg b/Documentation/images/field_options.jpg deleted file mode 100644 index 9827d3ef9..000000000 Binary files a/Documentation/images/field_options.jpg and /dev/null differ diff --git a/Documentation/images/main_window_f20.jpg b/Documentation/images/main_window_f20.jpg deleted file mode 100644 index a1f2bc8c0..000000000 Binary files a/Documentation/images/main_window_f20.jpg and /dev/null differ diff --git a/Documentation/images/tissues.jpg b/Documentation/images/tissues.jpg deleted file mode 100644 index bac1456f0..000000000 Binary files a/Documentation/images/tissues.jpg and /dev/null differ diff --git a/Documentation/images/usermanualfunctions.jpg b/Documentation/images/usermanualfunctions.jpg new file mode 100644 index 000000000..fe19ea8b4 Binary files /dev/null and b/Documentation/images/usermanualfunctions.jpg differ diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt index fc87e3a90..6ce4921f7 100644 --- a/Documentation/user-manual.txt +++ b/Documentation/user-manual.txt @@ -64,14 +64,32 @@ Divers toc::[] -[[S_UserSurvey]] + Using this manual ----------------- -When opened from within _Subsurface_, this manual does not have external controls. However, -a _SEARCH_ function is important. This is activated by pressing control-F or command-F on -the keyboard. A text box appears at the bottom of the window. Use this to search for -any term in the manual. +When opened from within _Subsurface_, this manual does not have external controls for +paging or selecting previous pages. However, two facilities are provided: + +- The _SEARCH_ function is activated by pressing control-F or command-F on +the keyboard. A text box appears at the bottom right-handof the window (see image below). +For instance, if one typed the word "_weights_" into the search text box, this word will +be searched for throughout this user manual. To the right of the search text box are two arrows pointing +up and down. Selecting these allow finding, respectively, the previous and the next occurence of +the term being searched for. + +image::images/usermanualfunctions.jpg["User manual functions",align="center"] + +- _PREVIOUS/NEXT LINK_. One can move between links (underlined words allowing one to +jump to specific sections in this user manual) by right-clicking on the text of the manual. +This brings up a context menu for jumping to previous links selected while reading the manual +(see image above). For instance if a link in the manual has been selected, then the option +to _Go Back_ shows the text at the last link that was selected (similar to the Previous Page +button in most web browsers). Conversely the _Go Forward_ option enables jumping to the +text perused before selecting the _Go Back_ option. The _Reload_ option causes the complete +user manual to be reladed into the user manual window. + +[[S_UserSurvey]] The user survey --------------- In order to develop _Subsurface_ in a way that serves its users in the best possible way, @@ -2189,13 +2207,16 @@ risk of exposure to the dangers associated with oxygen toxicity. [icon="images/icons/NDL.jpg"] [NOTE] -Clicking this button causes the Information Box to display the *No-deco Limit (NDL)* or the +Clicking this button causes the Information Box to display either the *No-deco Limit (NDL)* or the *Total Time to Surface (TTS)*. NDL is the time duration that a diver can continue with a dive, given the present depth, that does not require decompression (that is, before an ascent ceiling appears). Once one 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. +time. TTS is calculated assuming an ascent surface air consumption (SAC) for +the gas currently used. Even if the profile contains several gas +switches, TTS at a specific moment during the dive is calculated using the current gas. +For TTS longer than 2 hours, it is not accurately calculated and Subsurface only indicates _TTS > 2h_. [icon="images/icons/SAC.jpg"] [NOTE] -- cgit v1.2.3-70-g09d2