Edit pages to reflect jackd not being essential

[ardour-manual] / include / preferences.html

diff --git a/include/preferences.html b/include/preferences.html
index d844cd55a6fd5e6c0c3be75c5d39cb504774953d..cc5067bf988bb9fe9969e0766a21c6e69d7f2b5d 100644 (file)
--- a/include/preferences.html
+++ b/include/preferences.html
@@ -1,3 +1,10 @@
+<figure class="right">
+  <img src="/images/preferences.png" alt="The Preferences window">
+  <figcaption>
+    The Preferences window
+  </figcaption>
+</figure>
+
 <p>
   Global <dfn>preferences</dfn> control general workflow and system
   configuration, and should apply to all sessions. They are located in <kbd
@@ -5,7 +12,29 @@
   configuration file</dfn> in the user's home directory.
 </p>
 
-<h2 id="general">General</h2>
+<p>
+       Preferences are conveniently grouped by category:
+</p>
+
+<ul>
+       <li><a href="#preferences-general">General</a></li>
+       <li><a href="#preferences-editor">Editor</a></li>
+       <li><a href="#preferences-mixer">Mixer</a></li>
+       <li><a href="#preferences-signal_flow">Signal Flow</a></li>
+       <li><a href="#preferences-audio">Audio</a></li>
+       <li><a href="#preferences-midi">MIDI</a></li>
+       <li><a href="#preferences-metronome">Metronome</a></li>
+       <li><a href="#preferences-metering">Metering</a></li>
+       <li><a href="#preferences-transport">Transport</a></li>
+       <li><a href="#preferences-sync">Sync</a></li>
+       <li><a href="#preferences-control_surfaces">Control Surfaces</a></li>
+       <li><a href="#preferences-midi_ports">MIDI Ports</a></li>
+       <li><a href="#preferences-plugins">Plugins</a></li>
+       <li><a href="#preferences-appearance">Appearance</a></li>
+       <li><a href="#preferences-video">Video</a></li>
+</ul>
+
+<h2 id="preferences-general">General</h2>
 
 <ul>
   <li>
@@ -155,7 +184,7 @@
   </li>
 </ul>
 
-<h2 id="editor">Editor</h2>
+<h2 id="preferences-editor">Editor</h2>
 
 <ul>
   <li>
@@ -275,7 +304,7 @@
   provides a way to revert any user made change to its default value.
 </p>
 
-<h2 id="mixer">Mixer</h2>
+<h2 id="preferences-mixer">Mixer</h2>
 
 <ul>
   <li>
@@ -368,7 +397,7 @@
 
 </ul>
 
-<h2 id="signal_flow">Signal Flow</h2>
+<h2 id="preferences-signal_flow">Signal Flow</h2>
 
 <ul>
   <li>
@@ -418,7 +447,7 @@
   </li>
 </ul>
 
-<h2 id="audio">Audio</h2>
+<h2 id="preferences-audio">Audio</h2>
 
 <ul>
   <li>
@@ -481,7 +510,7 @@
   </li>
 </ul>
 
-<h2 id="midi">MIDI</h2>
+<h2 id="preferences-midi">MIDI</h2>
 
 <ul>
   <li>
@@ -501,7 +530,7 @@
     <ul>
       <li>
         <dfn>Initial program change:</dfn> Ardour will send a MIDI program
-        change message on the <code>ardour:MMC out</code> JACK port when a session
+        change message on the <code>ardour:MMC out</code> MIDI port when a session
         is loaded and whenever this field is changed. A value of -1 means don't
         send any program change message.
       </li>
@@ -526,7 +555,7 @@
   </li>
 </ul>
 
-<h2 id="metronome">Metronome</h2>
+<h2 id="preferences-metronome">Metronome</h2>
 
 <ul>
   <li>
@@ -570,7 +599,7 @@
   </li>
 </ul>
 
-<h2 id="metering">Metering</h2>
+<h2 id="preferences-metering">Metering</h2>
 
 <ul>
   <li>
@@ -646,7 +675,7 @@
   </li>
 </ul>
 
-<h2 id="transport">Transport</h2>
+<h2 id="preferences-transport">Transport</h2>
 
 <ul>
   <li>
@@ -717,7 +746,7 @@
   </li>
 </ul>
 
-<h2 id="sync">Sync</h2>
+<h2 id="preferences-sync">Sync</h2>
 
 <ul>
   <li>
@@ -810,7 +839,7 @@
       <li>
         <dfn>Enable Mclk generator</dfn> when enabled Ardour will generate a
         (tempo dependant) beat clock at a rate of 24 pulses per quarter note on
-        the <code>ardour:MIDI clock out</code> JACK port.
+        the <code>ardour:MIDI clock out</code> port.
       </li>
     </ul>
   </li>
@@ -820,7 +849,7 @@
     <ul>
       <li>
         <dfn>Enable MTC Generator</dfn> when enabled Ardour will generate MIDI
-        time code on the <code>ardour:MTC out</code> JACK port.
+        time code on the <code>ardour:MTC out</code> MIDI port.
       </li>
       <li>
         <dfn>Percentage either side of normal transport speed to transmit MTC:</dfn>
@@ -837,17 +866,17 @@
       <li>
         <dfn>Respond to MMC commands</dfn> when enabled Ardour will respond
         to MIDI Machine Control commands received on the <code>ardour:MMC in</code>
-        JACK port.
+        MIDI port.
       </li>
       <li>
         <dfn>Send MMC commands</dfn> when enabled Ardour will send MIDI Machine
         Control commands on the <code>ardour:MMC out</code>
-        JACK port.
+        MIDI port.
       </li>
       <li>
         <dfn>Inbound MMC device ID:</dfn> is the only device ID Ardour will
         respond to when an MMC command is received on the <code>ardour:MMC in</code>
-        JACK port.
+        MIDI port.
       </li>
       <li>
         <dfn>Outbound MMC device ID:</dfn> is the MIDI device ID Ardour will
@@ -857,7 +886,7 @@
   </li>
 </ul>
 
-<h2 id="control_surfaces">Control Surfaces</h2>
+<h2 id="preferences-control_surfaces">Control Surfaces</h2>
 
 <p>
   This tab contains settings for <a href="@@control-surfaces">control surfaces</a>.
@@ -870,7 +899,7 @@
   protocol settings</kbd> (only for Generic MIDI and Open Sound Control).
 </p>
 
-<h2 id="midi_ports">MIDI Ports</h2>
+<h2 id="preferences-midi_ports">MIDI Ports</h2>
 
 <ul>
   <li>
@@ -923,7 +952,7 @@
   </li>
 </ul>
 
-<h2 id="plugins">Plugins</h2>
+<h2 id="preferences-plugins">Plugins</h2>
 
 <p class="note">
   The content of this preference page varies heavily between versions or Ardour:
@@ -1102,7 +1131,7 @@
   </li>
 </ul>
 
-<h2 id="appearance">Appearance</h2>
+<h2 id="preferences-appearance">Appearance</h2>
 
 <ul>
   <li>
@@ -1435,7 +1464,7 @@
   </li>
 </ul>
 
-<h2 id="video">Video</h2>
+<h2 id="preferences-video">Video</h2>
 
 <ul>
   <li>