User manual update: Cloud services

This ammends the existing text on cloud services.

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

1 files changed, 47 insertions, 36 deletions

diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
index d9f228137..2c2415595 100644
--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt
@@ -2481,51 +2481,62 @@ reason, facilities such as _divelogs.de_ and _Diving Log_ offer to store
 dive log information on the Internet.
 
 _Subsurface_ includes access to a transparently integrated cloud storage
-backend that is available to all Subsurface users. In order to use the
-_Subsurface cloud storage_ the users need to follow these steps
-
-* Create a cloud storage account:
-
-** Open the _Preferences_
-** Under _Defaults_, in the _Subsurface cloud storage_ section, enter
-their email address and a password
-** Click _Apply_ or _Done_ to send email address and password to the
-server
-** The server will respond with an email to the given address that
-contains a verification PIN
-** Enter the PIN in the corresponding field in the _Preferences_ dialog
-(this field is only visible while the backend server is waiting for email
+backend that is available to all Subsurface users. Storing and retrieving a dive log
+from the cloud is no more difficult than accessing the dives on the local hard disk.
+The only requirement is that one should first register as a user on the cloud.
+To use _Subsurface cloud storage_ , follow these steps:
+
+=== Create a cloud storage account
+
+** Open the *Network Preferences* by selecting _File_ -> _Preferences_ -> _Network_.
+** In the section headed _Subsurface cloud storage_, enter an email address that
+   _Su bsurface can use for user registration.
+** Enter a novel password that_Subsurface_ will use to store the
+  dive log in the cloud.
+** Click _Apply_ to send the above email address and password to the
+  (remote) cloud server. The server responds by sending a verification PIN to
+  the above email address (This is the *only* occasion that _Subsurface_ uses the
+  email address provided above). The *Network Preferences* dialog now has a new PIN text
+   box, not visible previously.
+** Enter the PIN in the corresponding text box in the *Network Preferences* dialog
+(this field is only visible while the server is waiting for email
 address confirmation)
-** Click _Apply_ or _Done_ again, the _Subsurface cloud storage_ account
-will be marked as verified and the _Subsurface cloud storage_ service can
-be used
+** Click _Apply_ again. The _Subsurface cloud storage_ account
+will be marked as verified and the _Subsurface cloud storage_ service is initialised for use.
 
-* Use _Subsurface cloud storage_
+=== Using _Subsurface cloud storage_
 
-** From the _File_ menu users can load and save data to the _Subsurface
-cloud storage_ server
-** In the _Preferences_, users can select to use the _Subsurface cloud
-storage_ data as their default data file which means that the data from
-the _Subsurface cloud storage_ will be displayed when _Subsurface_ starts.
+** Once the cloud storage has been initialised, two new items appear in the
+   _File_ menu of the main menu system: _Open cloud storage_ and _Save to cloud storage_.
+These options allow the user to load and save data to the _Subsurface
+cloud storage_ server.
+** In the _Defaults Preferences_ tab, one can select to use the _Subsurface cloud
+storage_ data as one's default data file by checking the check box marked _Cloud storage default file_.
+ This means that the data from
+the _Subsurface cloud storage_ is loaded when _Subsurface_ starts ans saved there when one closes _Subsurface_.
 
-_Subsurface_ keeps a local copy of the data and _Subsurface_ stays fully
-functional if used while offline. _Subsurface_ will simply synchronize the
-data with the backend serer the next time it is used while the computer is
-online.
+** _Subsurface_ keeps a local copy of the data and the cloud facility remains fully
+functional even if used while disconnected to the Internet. _Subsurface_ simply synchronises the
+data with the cloud server the next time ithe program is used while the computer is
+connected to the Internet.
 
-* Web access to _Subsurface cloud storage_
+=== Web access to _Subsurface cloud storage_
 
 One of the nice side benefits of using _Subsurface cloud storage_ is that
-you can also access your dive data from any web browser. Simply open
-https://cloud.subsurface-divelog.org[https://cloud.subsurface-divelog.org],
+one can also access one's dive data from any web browser. Simply open
+https://cloud.subsurface-divelog.org[_https://cloud.subsurface-divelog.org_],
 log in with the same email and password, and you can see an HTML export of
-the latest dive data that was synced to the _Subsurface cloud storage_.
+the last dive data that was synced to the _Subsurface cloud storage_. The dive information
+that is shown is only the contents of the recorded dive logs, NOT the calculated values
+shown in the *Profile* panel,
+including some cylinder pressures, deco ceilings and O~2~/He/N~2~ partial pressures.
 
-If you prefer not to use the integrated cloud storage of dive logs (and
-don't need the web access to your data), it is also simple to store your
+=== Other cloud services
+
+If one prefers not to use the integrated cloud storage of dive logs (and
+don't need the web access), it is also simple to store
 dive logs in the cloud using several of the existing facilities on the
 Internet.
-
 For instance
 http://www.dropbox.com/[_Dropbox_]
 offers a free application that allows
@@ -2548,9 +2559,9 @@ involved for this service. Dropbox (Windows, Mac
 and Linux) can be installed by accessing the
 http://www.dropbox.com/install[_Install Page on the Dropbox website_]
 . Alternatively one can use _Dropbox_ as a mechanism to backup one's dive log. To
-Store a dive log in the Cloud, select _File ->  Save as_ from the _Subsurface_ main menu,
+Store a dive log on _Dropbox_, select _File ->  Save as_ from the _Subsurface_ main menu,
 navigate to the _Dropbox_ folder and select the _Save_ button. To access the dive log
-in the Cloud, select _File ->  Open Logbook_ from the _Subsurface_
+in _Dropbox_, select _File ->  Open Logbook_ from the _Subsurface_
 main menu and navigate to the dive log file in the _Dropbox_ folder and select the
 _Open_ button.