diff options
| -rw-r--r-- | Documentation/user-manual.txt | 83 |
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. |