Total rework of the *Ardour's Interface* part

[ardour-manual] / _manual / 01_welcome-to-ardour / 02_about-ardour-documentation.html

diff --git a/_manual/01_welcome-to-ardour/02_about-ardour-documentation.html b/_manual/01_welcome-to-ardour/02_about-ardour-documentation.html
index e788cd5cd595098ffa964561b52aa51531c1dacb..99c59ecd41244f22f3cb3634e5696d94cee00cd0 100644 (file)
--- a/_manual/01_welcome-to-ardour/02_about-ardour-documentation.html
+++ b/_manual/01_welcome-to-ardour/02_about-ardour-documentation.html
@@ -15,7 +15,7 @@ title: About Ardour documentation
   <kbd class="mod1">x</kbd>.
 </p>
 <p>
-  <kbd>Ctrl x</kbd> means "press the <kbd>Ctrl</kbd> key, keep it pressed
+  <kbd class="mod1">x</kbd> means "press the <kbd class="mod1">&nbsp;</kbd> key, keep it pressed
   and then also press the <kbd>x</kbd> key.
 </p>
 <p>
@@ -29,14 +29,14 @@ title: About Ardour documentation
   Note that different platforms have different conventions for which
   modifier key (Control or Command) to use as the primary or most common
   modifier. When viewing this manual from a machine identifying itself as
-  running OS X, you will see  <kbd>Cmd </kbd> where appropriate (for instance
-  in the first example above). On other machines you will see <kbd>Ctrl </kbd>
-  instead.
+  running OS X, you will see  <kbd>Cmd&nbsp;</kbd> where appropriate (for instance
+  in the first example above). On other machines you will see
+  <kbd>Ctrl&nbsp;</kbd> instead.
 </p>
  
 <h3>Mouse Buttons</h3>
 <p>
-  We refer to <a href="/setting-up-your-system/the-mouse">mouse buttons</a> as 
+  We refer to <a href="/setting-up-your-system/mouse/">mouse buttons</a> as 
   <kbd class="mouse">Left</kbd>, <kbd class="mouse">Middle</kbd> and
   <kbd class="mouse">Right</kbd>. Ardour can use additional buttons, but they have
   no default behaviour in the program.
@@ -48,10 +48,18 @@ title: About Ardour documentation
   modifier key, for example <kbd class="mouse mod1">Left</kbd>.
 </p>
 
-<h4>"Context-click"</h4>
+<h4>Mouse wheel</h4>
 <p>
-  Many times the term <kbd class="mouse">context-click</kbd> is used to indicate
-  that you should (typically) right-click on a particular element of the graphical 
+  Some GUI elements can optionally be controlled with the mouse wheel when
+  the pointer is hovering over them. The notation for mouse wheel action is
+  <kbd class="mouse">&uArr;</kbd> <kbd class="mouse">&lArr;</kbd>
+  <kbd class="mouse">&dArr;</kbd> <kbd class="mouse">&rArr;</kbd>.
+</p>
+
+<h4>Context-click</h4>
+<p>
+  The term <dfn>context-click</dfn> is used to indicate
+  that you should (typically) <kbd class="mouse">Right</kbd>-click on a particular element of the graphical 
   user interface. Although right-click is the common, default way to do this, there 
   are other ways to accomplish the same thing - this term refers to any of them, 
   and the result is always that a menu specific to the item you clicked on will be
@@ -101,9 +109,9 @@ title: About Ardour documentation
   such as this</kbd>. In rare cases, you will be required to perform certain
   operations at the command line of your operating system:
 </p>
-<kbd class="lincmd">cat /proc/cpuinfo</kbd>
-<kbd class="maccmd">sleep 3600</kbd>
-<kbd class="wincmd">ping www.google.com</kbd>
+<kbd class="cmd lin">cat /proc/cpuinfo</kbd>
+<kbd class="cmd mac">sleep 3600</kbd>
+<kbd class="cmd win">ping www.google.com</kbd>
 
 <h3>Program Output</h3>
 <p>
@@ -119,7 +127,7 @@ title: About Ardour documentation
 
 <h3>Warnings</h3>
 <p class="warning">
-  Hairy issues that might cause things to go wrong, lose data, or impair sound
-  quality is displayed in this way.
+  Hairy issues that might cause things to go wrong, lose data, impair sound
+  quality, or eat your proverbial goldfish, are displayed in this way.
 </p>