mifr/subsurface
1
0
Fork 0
mirror of https://github.com/subsurface/subsurface.git synced 2025-02-19 22:16:15 +00:00
Code Issues Projects Releases Packages Wiki Activity

User manual: correct asciidoc markup for proper alignment of subheadings

Browse source 
Sections 6 and 9.3 of the user manual has some problems with the
ascii-doc code for maintaining the prper alignment of subheadings.
This patch corrects the asciidoc markup code to solve this
problem

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 2014-07-23 08:05:23 +02:00 • committed by Dirk Hohndel
parent 6d5905419e
commit 6509201c1e
1 changed files with 16 additions and 22 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

36
Documentation/user-manual.txt
View file

@ -1858,17 +1858,17 @@ 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:
* _General Settings_, under the HTML tab, provides the following options:
*** Subsurface Numbers: if this option is checked, the dive(s) are exported with the
** 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.
*** Minimum Javascript: This will minimize the Javascript produced with the file,
** Minimum Javascript: This will minimize the Javascript produced with the file,
some functionality will be lost.
*** Export List only: a list of dives will only be exported and the detailed dive
** Export List only: a list of dives will only be exported and the detailed dive
information will not be available.
** Under _Style Options_ some style-related options are available like font
* Under _Style Options_ some style-related options are available like font
size and theme.
Export to other formats can be achieved through third party facilities, for
@ -2130,25 +2130,21 @@ planning.
=== Managing nitrogen, oxygen and gas consumption
- The planning is performed in three stages:
The planning is performed in three stages:
** *a) Nitrogen management*: This is performed by specifying the rates for descent and ascent,
- *a) Nitrogen management*: This is performed by specifying the rates for descent and ascent,
as well as the gradient factors (GFLow and GFHigh) under the headings _Rates_ and _Planning_
to the bottom left of the planning screen. Initially, the GFHigh and GFLow values in the _Preferences_
panel of _Subsurface_ is used. If these are changed within the planner (see _Gas Options_ within
the planner), the new values are
used without changing the original specifications in the _Preferences_.
Gradient Factor settings strongly affect the calculated ceilings and their depths.
used without changing the original specifications in the _Preferences_. Gradient Factor settings strongly affect the calculated ceilings and their depths.
A very low GFLow value brings about decompression stops early on during the dive.
For more information about Gradient factors, see the section on xref:S_GradientFactors[Gradient Factor Preference settings].
** For more information about Gradient factors, see the section on xref:S_GradientFactors[Gradient Factor Preference settings].
For more information external to this manual see:
** link:http://www.tek-dive.com/portal/upload/M-Values.pdf[Understanding M-values by Erik Baker, _Immersed_ Vol. 3, No. 3.]
** link:http://www.rebreatherworld.com/general-and-new-to-rebreather-articles/5037-gradient-factors-for-dummies.html[Gradient factors for dummies, by Kevin Watts]
** link: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[_Deco for Divers_, by Mark Powell (2008). Aquapress] Southend-on-Sea, UK. ISBN 10: 1-905492-07-3.
*** link:http://www.tek-dive.com/portal/upload/M-Values.pdf[Understanding M-values by Erik Baker, _Immersed_ Vol. 3, No. 3.]
*** link:http://www.rebreatherworld.com/general-and-new-to-rebreather-articles/5037-gradient-factors-for-dummies.html[Gradient factors for dummies, by Kevin Watts]
*** link: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[_Deco for Divers_, by Mark Powell (2008). Aquapress] Southend-on-Sea, UK. ISBN 10: 1-905492-07-3.
An excellent non-technical review.
** The ascent rate is critical for nitrogen off-gassing at the end of the dive and is specified
@ -2160,19 +2156,17 @@ is activated, then the descent phase of the planned dive will be at the maximal
in the _Rates_ section of the dive setup.
** *b) Oxygen management*: In the *Gas Options* part of the dive specification, the maximum partial
- *b) Oxygen management*: In the *Gas Options* part of the dive specification, the maximum partial
pressure for oxygen needs to be specified for the
bottom part of the dive (_bottom po2_) as well as for the decompression part of the dive (_deco po2_).
The most commonly
used values are 1.4 bar for the bottom part of the dive and 1.5 bar for any decompression
stages. Normally, a partial pressure of 1.5 bar is not exceeded.
Po2 settings and the depth at which switching to a gas takes place can also be edited in the
stages. Normally, a partial pressure of 1.5 bar is not exceeded. PO2 settings and the depth at which switching to a gas takes place can also be edited in the
_Available Gases_ 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.
** *c) Gas management*: One needs keep within the limits of the amount of gas contained in the dive
- *c) Gas management*: One needs keep within the limits of the amount of gas contained in the dive
cylinder(s), allowing for an appropriate margin for safe return to the surface, possibly
sharing with a buddy. Under the _Gas Options_ heading, specify the best (but conservative) estimate
of your surface-equivalent air consumption (SAC, also termed RMV) in litres/min (or cft/min,