More AsciiDoc updates

Add missing internal links

Work on better visual representation of structured data

Start creating quoted text (instead of styled text)

Signed-off-by: Dirk Hohndel <dirk@hohndel.org>

diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
index d65f80eed5d04a4a58ff3c8de6ec5e9fbe1b4fe6..aeee6a744c2a3337d9697c86123944b43774d015 100644 (file)
--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt
@@ -116,27 +116,19 @@ An example:
 
 On Sunday Oct 23, 2011 you made a dive.
 In the log line of this dive, you see the following information:
 
 On Sunday Oct 23, 2011 you made a dive.
 In the log line of this dive, you see the following information:

-
- #::
-       12                      Dive number
- Date::
-       Sun, Oct 23, 2011 10:50         Date and time of your dive
- *::
-                               Your rating (none at this time)
- m::
-       12.8                    Your maximum depth in meters
- min::
-       31:20                   Your dive-time in minutes and seconds
- Deg. C::
-       13.0                    Lowest water temperature during your dive
- Cyl::
-                               Your used cylinder (none at this time)
- O2%::
-       air                     What type of mixture
- SAC::
-                               SAC (none at this time)
- Location::
-                               Where you performed your dive (empty)
+[width="70%",cols="<5%,10%,<20%,<65%",grid="none",frame="none",style="monospaced"]
+|===============================================================================
+|| #      | 12                      | Dive number
+|| Date           | Sun, Oct 23, 2011 10:50 | Date and time of your dive
+|| *      |                         | Your rating (none at this time)
+|| m      | 12.8                    | Your maximum depth in meters
+|| min    | 31:20                   | Your dive-time in minutes and seconds
+|| Deg. C   | 13.0                  | Lowest water temperature during your dive
+|| Cyl    |                         | Your used cylinder (none at this time)
+|| O2%    | air                     | What type of mixture
+|| SAC    |                         | SAC (none at this time)
+|| Location |                       | Where you performed your dive (empty)
+|===============================================================================

 
 As you can see, some information is already there because it is
 retrieved from your divecomputer. Some information is waiting for
 
 As you can see, some information is already there because it is
 retrieved from your divecomputer. Some information is waiting for


@@ -152,24 +144,24 @@ When you double click on the dive log line, the editor window
 opens. Now you can add information that is missing. Let start with
 completing the example:
 
 opens. Now you can add information that is missing. Let start with
 completing the example:
 

-You double clicked on dive #12, as described in 5. Viewing and
-completing your logs.  The Dive Info window pops up and you will see
+You double clicked on dive #12, as described in <<S_ViewingLogs,Viewing and
+completing your logs>>.  The Dive Info window pops up and you will see

 the following:
 the following:

-
- - Location:    An input where you can enter your new location, or you can choose with the pull-down previous locations
- - Dive Master: An input where you can enter the name of your Dive Master, or you can choose with the pull-down a previous name
- - Buddy:       An input where you can enter het name of you Buddy, or you can choose with the pull-down a previous name
- - Rating:      A pull-down where you can rate your dive.
- - Notes:       A free input where you can enter information about your dive. What you've seen, etc.
+[horizontal]
+ *Location*::   An input where you can enter your new location, or you can choose with the pull-down previous locations
+ *Dive Master*:: An input where you can enter the name of your Dive Master, or you can choose with the pull-down a previous name
+ *Buddy*::      An input where you can enter het name of you Buddy, or you can choose with the pull-down a previous name
+ *Rating*::     A pull-down where you can rate your dive.
+ *Notes*::      A free input where you can enter information about your dive. What you've seen, etc.

 
 In this example we use the following information:
 
 In this example we use the following information:

-
- - Location:           Oostvoornse Meer
- - Dive Master:                S. de Vries
- - Buddy:              S. de Vries
- - Rating:             3 stars
- - Notes:              First dive here. Good visibility. Did see the concrete poles, some crab and fish. Very nice and easy dive.
-                        Made movie with 'headcam'.
+[horizontal]
+ *Location*::          Oostvoornse Meer
+ *Dive Master*::       S. de Vries
+ *Buddy*::             S. de Vries
+ *Rating*::            3 stars
+ *Notes*::             First dive here. Good visibility. Did see the concrete poles, some crab and fish. Very nice and easy dive. +
+                        Made movie with headcam.

 
 Now don't press ok yet!
 
 
 Now don't press ok yet!
 


@@ -187,7 +179,7 @@ So, when you double click on the cylinder info, you get another
 popup. This popup gives you the following:
 
  - Cylinder:   Pull-down where you can choose your Cylinder, or add your own
 popup. This popup gives you the following:
 
  - Cylinder:   Pull-down where you can choose your Cylinder, or add your own

- - Size:       The volume if not 'filled'
+ - Size:       The volume if not `filled'

  - Pressure:   The maximum pressure of this Cylinder
  - Optional:
                * Start Pressure: What was the pressure starting the dive
  - Pressure:   The maximum pressure of this Cylinder
  - Optional:
                * Start Pressure: What was the pressure starting the dive


@@ -513,7 +505,7 @@ The file menu is used for the following menu options:
  - Save::              Save your current divelogs or changes you made to your divelogs
  - Print::             Print your current divelog profiles and information about the dive
  - Import::    Import your dives from your divecomputer, JDivelogs or Suunto Divemanager
  - Save::              Save your current divelogs or changes you made to your divelogs
  - Print::             Print your current divelog profiles and information about the dive
  - Import::    Import your dives from your divecomputer, JDivelogs or Suunto Divemanager

- - Preferences::       Set your preferences as described in chapter 10
+ - Preferences::       Set your preferences as described in <<S_SettingUpPreferences,chapter 10>>

  - Quit::              Quit the program
 
 The Log menu
  - Quit::              Quit the program
 
 The Log menu