Yet some more changes to Companion part of user manualv4.1

A last few changes before 4.1.
The first figure in "Using Companion app" needs a third part.
This was inserted. Which, in turn, affected the last figure
in that section. So that was also changed accordingly.

Few tiny changes to text to clean up references to figures.

Signed-off-by: Willem Ferguson <willemferguson@zoology.up.ac.za>
Signed-off-by: Dirk Hohndel <dirk@hohndel.org>

6 files changed, 156 insertions, 60 deletions

diff --git a/Documentation/images/Companion.jpg b/Documentation/images/Companion.jpg
deleted file mode 100644
index 419aeb519..000000000
--- a/Documentation/images/Companion.jpg
+++ /dev/null
diff --git a/Documentation/images/Companion_1.jpg b/Documentation/images/Companion_1.jpg
new file mode 100644
index 000000000..0f88bfe02
--- /dev/null
+++ b/Documentation/images/Companion_1.jpg
diff --git a/Documentation/images/Companion_2.jpg b/Documentation/images/Companion_2.jpg
deleted file mode 100644
index 7ff71fb79..000000000
--- a/Documentation/images/Companion_2.jpg
+++ /dev/null
diff --git a/Documentation/images/Companion_5.jpg b/Documentation/images/Companion_5.jpg
new file mode 100644
index 000000000..7809f2f45
--- /dev/null
+++ b/Documentation/images/Companion_5.jpg
diff --git a/Documentation/user-manual.html.git b/Documentation/user-manual.html.git
index daff41257..3a44d03de 100644
--- a/Documentation/user-manual.html.git
+++ b/Documentation/user-manual.html.git
@@ -409,7 +409,7 @@ asciidoc.install(3);
 </div>

 <div class="paragraph"><p><span class="big">USER MANUAL</span></p></div>

 <div class="paragraph"><p><strong>Manual authors</strong>: Willem Ferguson, Jacco van Koll, Dirk Hohndel, Reinout Hoornweg,

-Linus Torvalds, Miika Turkia, Amit Chaudhuri, Jan Schubert,  Salvador Cuñat</p></div>

+Linus Torvalds, Miika Turkia, Amit Chaudhuri, Jan Schubert, Salvador Cuñat</p></div>

 <div class="paragraph"><p><span class="blue"><em>Version 4.1,  May 2014</em></span></p></div>

 <div class="paragraph"><p>Welcome as a user of <em>Subsurface</em>, an advanced dive logging programme with

 extensive infrastructure to describe, organise, interpret and print scuba

@@ -1612,11 +1612,13 @@ divelog. The Companion App stores the dive locations on
 a dedicated Internet-based file server. <em>Subsurface</em>, in turn, can collect

 the localities from the file server.</p></div>

 <div class="paragraph"><p>To do this:</p></div>

+<div class="sect3">

+<h4 id="_create_a_companion_app_account">3.4.1. Create a Companion App account</h4>

 <div class="ulist"><ul>

 <li>

 <p>

 Register on the <a href="http://api.hohndel.org/login/"><em>Subsurface companion web page</em></a>.

-A confirmation email with instructions and a personal <strong>DIVERID</strong> will be send together with

+A confirmation email with instructions and a personal <strong>DIVERID</strong> will be sent,

 a long number that gives access to the file server and Companion App capabilities.

 </p>

 </li>

@@ -1624,85 +1626,159 @@ a long number that gives access to the file server and Companion App capabilitie
 <p>

 Download the app from

 <a href="https://play.google.com/store/apps/details?id=org.subsurface">Google Play Store</a>

-or

-from

+or from

 <a href="http://f-droid.org/repository/browse/?fdfilter=subsurface&amp;fdid=org.subsurface">F-Droid</a>.

 </p>

 </li>

 </ul></div>

+</div>

 <div class="sect3">

-<h4 id="_using_the_subsurface_companion_app_on_a_smartphone">3.4.1. Using the Subsurface companion app on a smartphone</h4>

+<h4 id="_using_the_subsurface_companion_app_on_a_smartphone">3.4.2. Using the Subsurface companion app on a smartphone</h4>

 <div class="paragraph"><p>On first use the app has three options:</p></div>

 <div class="ulist"><ul>

 <li>

 <p>

 <em>Create a new account.</em>  Equivalent to registering in <em>Subsurface</em> companion

-page using an Internet browser.

+page using an Internet browser. One can request a <strong>DIVERID</strong> using this option,

+but this is supplied via email and followed up by interaction with the

+<a href="http://api.hohndel.org/login/"><em>Subsurface companion web page</em></a> in order to

+activate the account.

 </p>

 </li>

 <li>

 <p>

-<em>Retrieve an account.</em>  If users forgot their DIVERID they will receive an email

+<em>Retrieve an account.</em>  If users forgot their <strong>DIVERID</strong> they will receive an email

 to recover the number.

 </p>

 </li>

 <li>

 <p>

-<em>Use an existing account.</em> Users are prompted for their DIVERID. The app saves

-this DIVERID and does not ask for it again unless one uses the <em>Disconnect</em> menu

+<em>Use an existing account.</em> Users are prompted for their <strong>DIVERID</strong>. The app saves

+this <strong>DIVERID</strong> and does not ask for it again unless one uses the <em>Disconnect</em> menu

 option (see below).

 </p>

 </li>

 </ul></div>

-<div class="paragraph"><p>Now one is ready to get a dive position and send it to the server. The Android

-display will look like the left hand image (<strong>A</strong>) below, but without any dive.</p></div>

-<div class="paragraph"><p>Touch the "+" icon on the top right to add a new dive site, resulting in a prompt

-for a place name (or a request to activate the GPS if it is turned off).

-The main screen shows a list of dive locations, each with a name, date and

-time. Some locations may have an arrow-up icon on the selection box to the left (see

-image B in the middle, below) indicating that they require upload to the server.</p></div>

-<div class="paragraph"><p>There are several ways to send locationd to the server; the easiest is by simply

-selecting the location. See middle image below (<strong>B</strong>):</p></div>

-<div class="imageblock" style="text-align:center;">

-<div class="content">

-<img src="images/Companion.jpg" alt="FIGURE: Screen shots (A-C) of companion app" />

-</div>

-</div>

-<div class="paragraph"><p>Touching the right arrow will send it to the server.</p></div>

 <div class="admonitionblock">

 <table><tr>

 <td class="icon">

 <img src="images/icons/important.png" alt="Important" />

 </td>

-<td class="content">Users must be careful, as the trash icon on the right means exactly what it should mean:

-it deletes the dive location(s).</td>

+<td class="content">In the <em>Subsurface</em> main program, the <strong>DIVERID</strong> should also be entered on the

+Default Preferences

+panel, obtained by selecting <em>File&#8594;Preferences&#8594;Defaults</em> from the main menu

+in <em>Subsurface</em> itself.

+This facilitates synchronisation between <em>Subsurface</em> and the Companion App.</td>

 </tr></table>

 </div>

-<div class="paragraph"><p>New dive locations are now stored on the server and can be downloaded to the

-<em>Subsurface</em> dive log whenever users upload or add dives to <em>Subsurface</em>.

-After a dive trip using the Companion App, all dive locations are ready to be

-saved on a <em>Subsurface</em> dive log (see below).</p></div>

-<div class="paragraph"><p>When you click on a dive (<strong>not</strong> selecting the check button as shown in the images above), the

-name given to it, date/time and GPS coordinates will be shown, with two options:</p></div>

+<div class="sect4">

+<h5 id="_creating_new_dive_locations">Creating new dive locations</h5>

+<div class="paragraph"><p>Now one is ready to get a dive position and

+send it to the server. The Android

+display will look like the left hand image (<strong>A</strong>) below, but without any dive.</p></div>

+<div class="paragraph"><p>Touch the "+" icon on the top right to add a new dive site, a menu will be

+showed with 3 options:</p></div>

 <div class="ulist"><ul>

 <li>

 <p>

-Edit:  Change the text name of the dive location.

+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.

 </p>

 </li>

 <li>

 <p>

-Maps:  Display a map showing the dive location (you&#8217;ll be prompted to

-choose which helper app use from your installed apps). Currently this feature is

-non fully functional, but is under active development.

+Use Map: This option allows the user to fix a position by searching a world map. A

+world map is shown (see <strong>B</strong> below) on which one should indicate the desired position

+with a <em>long press</em> 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 <strong>C</strong> below). In order to import this

+dive location in <em>Subsurface</em> it&#8217;s advisable to set the time to agree with the time of

+that dive on the dive computer.

 </p>

 </li>

 </ul></div>

-<div class="paragraph"><p>After editing and saving a dive location, one needs to upload it to the web

+<div class="imageblock" style="text-align:center;">

+<div class="content">

+<img src="images/Companion_5.jpg" alt="FIGURE: Companion App, add location using map" />

+</div>

+</div>

+<div class="ulist"><ul>

+<li>

+<p>

+Import local GPX file: The android device searches for .gpx files and located

+archives will be shown. The selected .gpx file is opened and 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.

+</p>

+</li>

+</ul></div>

+</div>

+<div class="sect4">

+<h5 id="_lists_of_dive_locations">Lists of dive locations</h5>

+<div class="paragraph"><p>The main screen shows a list of dive locations, each with a name, date and

+time (see <strong>A</strong> below). Some locations may have an arrow-up icon over the selection box to the left

+indicating that they require upload to the server. One

+can select individual dive locations from the list. A selected location has a

+check mark in the selection box on the left. Group operations (such as <em>Delete</em> or <em>Send</em>)

+are performed on several locations that are selected.</p></div>

+<div class="paragraph"><p>Dive locations in this list can be viewed in two ways: a list of locations or a

+map indicating the dive locations. The display mode (List or Map) is changed by

+selecting <em>Dives</em> at the top left of the screen (see <strong>A</strong> below) and then selecting

+the display mode. The display mode can be changed either from the list

+of locations or from the map (see <strong>B</strong> below). If one selects a location (on the list

+or on the map), an editing

+panel opens (see <strong>C</strong> below) where the dive description or other details may be changed.</p></div>

+<div class="imageblock" style="text-align:center;">

+<div class="content">

+<img src="images/Companion_4.jpg" alt="FIGURE: Companion App, add location using map" />

+</div>

+</div>

+<div class="paragraph"><p>When one clicks on a dive (<strong>not</strong> selecting the check box), the

+name given to it, date/time and GPS coordinates will be shown, with two options at the top

+of the screen:</p></div>

+<div class="ulist"><ul>

+<li>

+<p>

+Edit (pencil):  Change the text name or other characteristics of the dive location.

+</p>

+</li>

+<li>

+<p>

+Maps:  Display a map showing the dive location.

+</p>

+</li>

+</ul></div>

+<div class="paragraph"><p>After editing and saving a dive location (see <strong>C</strong> above), one needs to upload it to the web

 service, as explained above.</p></div>

+</div>

+<div class="sect4">

+<h5 id="_uploading_dive_locations">Uploading dive locations</h5>

+<div class="paragraph"><p>There are several ways to send locations to the server.

+The easiest is by simply

+selecting the locations (See <strong>A</strong> below) and then touching the right arrow at the

+top right of the screen.</p></div>

+<div class="admonitionblock">

+<table><tr>

+<td class="icon">

+<img src="images/icons/important.png" alt="Important" />

+</td>

+<td class="content">Users must be careful, as the trash icon on the right means exactly what it should:

+it deletes the selected dive location(s).</td>

+</tr></table>

+</div>

+<div class="imageblock" style="text-align:center;">

+<div class="content">

+<img src="images/Companion_1.jpg" alt="FIGURE: Screen shots (A-B) of companion app" />

+</div>

+</div>

+<div class="paragraph"><p>After a dive trip using the Companion App, all dive locations are ready to be

+downloaded to a <em>Subsurface</em> dive log (see below).</p></div>

+</div>

 <div class="sect4">

 <h5 id="_settings_on_the_companion_app">Settings on the Companion app</h5>

-<div class="paragraph"><p>Selecting the <em>Settings</em> menu option results in the right hand image above (<strong>C</strong>).</p></div>

+<div class="paragraph"><p>Selecting the <em>Settings</em> menu option results in the right hand image above (<strong>B</strong>).</p></div>

 </div>

 <div class="sect4">

 <h5 id="_server_and_account">Server and account</h5>

@@ -1821,7 +1897,7 @@ of another registered diver.</p></div>
 </div>

 </div>

 <div class="sect3">

-<h4 id="_downloading_dive_locations_to_the_em_subsurface_em_divelog">3.4.2. Downloading dive locations to the <em>Subsurface</em> divelog</h4>

+<h4 id="_downloading_dive_locations_to_the_em_subsurface_em_divelog">3.4.3. Downloading dive locations to the <em>Subsurface</em> divelog</h4>

 <div class="paragraph"><p>Download dive(s) from a dive computer or enter them manually into

 <em>Subsurface</em> before obtaining the GPS coordinates from the server. The download

 dialog can be reached via <em>Ctrl+G</em> or from the <em>Subsurface</em> Main Menu <em>Import

@@ -2420,7 +2496,7 @@ below shows the depth profile two such dives that were merged:</p></div>
 <div class="sect1">

 <h2 id="S_ExportLog">6. Exporting the dive log or parts of the dive log</h2>

 <div class="sectionbody">

-<div class="paragraph"><p>A dive log can be saved in two formats:</p></div>

+<div class="paragraph"><p>A dive log can be saved in three formats:</p></div>

 <div class="ulist"><ul>

 <li>

 <p>

@@ -2434,15 +2510,24 @@ UDDF is a generic format that enables communication among many dive computers
 and computer programs.

 </p>

 </li>

+<li>

+<p>

+CSV format, that includes the most critical information of the dive

+profile. Included information of a dive is: number, date, time,

+duration, depth, temperature and pressure.

+</p>

+</li>

 </ul></div>

 <div class="paragraph"><p>In order to save the WHOLE dive log (i.e. all trips and dives), select <strong>File</strong>

 from the Main menu. To save in <em>Subsurface</em> XML format, select <em>File &#8594; Save as</em>.

-To save in UDDF format, select <em>File &#8594; Export UDDF</em>.</p></div>

+To save in UDDF format, select <em>File &#8594; Export UDDF</em> and to save in CSV

+format, select <em>File &#8594; Export CSV</em>.</p></div>

 <div class="paragraph"><p>In order to save only one or more dives or one or two trips, select the

 appropriate dives or trips in the <strong>Dive List</strong> panel and then right-click the

 selected dives to bring up the context menu. To save in <em>Subsurface</em> XML

-format, select <em>Save as</em> from the context menu. To save in UDDF format, select

-<em>Export as UDDF</em> from the context menu.</p></div>

+format, select <em>Save as</em> from the context menu. To save in UDDF or CSV

+format, select <em>Export as UDDF</em> or <em>Export as CSV</em> from the context menu

+respectively.</p></div>

 <div class="paragraph"><p>Export to other formats can be achieved through third party facilities, for

 instance <em>www.divelogs.de</em>.</p></div>

 </div>

@@ -3587,7 +3672,7 @@ you may stay in the water for a long time, but spend most of it at the surface.
 <div id="footnotes"><hr /></div>

 <div id="footer">

 <div id="footer-text">

-Last updated 2014-04-29 22:07:43 PDT

+Last updated 2014-05-08 08:19:07 PDT

 </div>

 </div>

 </body>

diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
index 5bb7dd2d8..6a6779edd 100644
--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt
@@ -1049,6 +1049,8 @@ the localities from the file server.
 
 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.
@@ -1083,7 +1085,10 @@ panel, obtained by selecting _File->Preferences->Defaults_ from the main menu
 in _Subsurface_ itself.
 This facilitates synchronisation between _Subsurface_ and the Companion App.
 
-Now one is ready to get a dive position and send it to the server. The Android
+===== Creating new dive locations
+
+Now one is ready to get a dive position and
+send it to the server. The Android
 display will look like the left hand image (*A*) below, but without any dive.
 
 Touch the "+" icon on the top right to add a new dive site, a menu will be
@@ -1093,14 +1098,15 @@ showed with 3 options:
 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 *A* below) on which one should indicate the desired position on the touch
+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 tab 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 *B* below). In order to import this
+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_2.jpg["FIGURE: Companion App, add location using map",align="center"]
+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
@@ -1109,17 +1115,19 @@ locations shown. Now one needs to select the appropriate locations, then select
 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.
 
+===== Lists of dive locations
+
 The main screen shows a list of dive locations, each with a name, date and
-time. Some locations may have an arrow-up icon in the selection box to the left (see
-image *B* in the middle, below) indicating that they require upload to the server. One
+time (see *A* below). Some locations may have an arrow-up icon over the selection box to the left
+indicating that they require upload to the server. One
 can select individual dive locations from the list. A selected location has a
-check mark in the selection box on the left. Group operations (such as Delete or Send)
+check mark in the selection box on the left. Group operations (such as _Delete_ or _Send_)
 are performed on several locations that are selected.
 
-Dive locations in the Companion can be viewed in two ways: a list of locations or a
+Dive locations in this list can be viewed in two ways: a list of locations or a
 map indicating the dive locations. The display mode (List or Map) is changed by
 selecting _Dives_ at the top left of the screen (see *A* below) and then selecting
-the display option. The display mode can be changed either from the list
+the display mode. The display mode can be changed either from the list
 of locations or from the map (see *B* below). If one selects a location (on the list
 or on the map), an editing
 panel opens (see *C* below) where the dive description or other details may be changed.
@@ -1127,19 +1135,22 @@ panel opens (see *C* below) where the dive description or other details may be c
 image::images/Companion_4.jpg["FIGURE: Companion App, add location using map",align="center"]
 
 
-When one clicks on a dive (*not* selecting the check button as shown in the images below), the
+When one clicks on a dive (*not* selecting the check box), the
 name given to it, date/time and GPS coordinates will be shown, with two options at the top
 of the screen:
 
-- Edit (pencil):  Change the text name of the dive location.
+- Edit (pencil):  Change the text name or other characteristics of the dive location.
 
 - Maps:  Display a map showing the dive location.
 
 After editing and saving a dive location (see *C* above), one needs to upload it to the web
 service, as explained above.
 
-There are several ways to send locations to the server; the easiest is by simply
-selecting the location (See *B* below) and then touching the right arrow at the
+===== Uploading dive locations
+
+There are several ways to send locations to the server.
+The easiest is by simply
+selecting the locations (See *A* below) and then touching the right arrow at the
 top right of the screen.
 
 [icon="images/icons/important.png"]
@@ -1147,7 +1158,7 @@ top right of the screen.
 Users must be careful, as the trash icon on the right means exactly what it should:
 it deletes the selected dive location(s).
 
-image::images/Companion.jpg["FIGURE: Screen shots (A-C) of companion app",align="center"]
+image::images/Companion_1.jpg["FIGURE: Screen shots (A-B) of companion app",align="center"]
 
 
 After a dive trip using the Companion App, all dive locations are ready to be
@@ -1156,7 +1167,7 @@ downloaded to a _Subsurface_ dive log (see below).
 
 ===== Settings on the Companion app
 
-Selecting the _Settings_ menu option results in the right hand image above (*C*).
+Selecting the _Settings_ menu option results in the right hand image above (*B*).
 
 ===== Server and account