+<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
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>
</li>
</ul>
-<h2 id="editor">Editor</h2>
+<h2 id="preferences-editor">Editor</h2>
<ul>
<li>
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>
</ul>
-<h2 id="signal_flow">Signal Flow</h2>
+<h2 id="preferences-signal_flow">Signal Flow</h2>
<ul>
<li>
</li>
</ul>
-<h2 id="audio">Audio</h2>
+<h2 id="preferences-audio">Audio</h2>
<ul>
<li>
</li>
</ul>
-<h2 id="midi">MIDI</h2>
+<h2 id="preferences-midi">MIDI</h2>
<ul>
<li>
<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>
</li>
</ul>
-<h2 id="metronome">Metronome</h2>
+<h2 id="preferences-metronome">Metronome</h2>
<ul>
<li>
</li>
</ul>
-<h2 id="metering">Metering</h2>
+<h2 id="preferences-metering">Metering</h2>
<ul>
<li>
</li>
</ul>
-<h2 id="transport">Transport</h2>
+<h2 id="preferences-transport">Transport</h2>
<ul>
<li>
</li>
</ul>
-<h2 id="sync">Sync</h2>
+<h2 id="preferences-sync">Sync</h2>
<ul>
<li>
<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>
<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>
<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
</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>.
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>
</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:
<li>
<dfn>Scan Time Out</dfn> Specifies the default timeout for plugin
instantiation. Plugins that require more time to load will be
- blacklisted. A value of &infinity; disables the timeout.
+ blacklisted. A value of ∞ disables the timeout.
</li>
<li>
<dfn>VST Cache:</dfn> Clicking the <kbd class="menu">Clear</kbd> button
</li>
</ul>
-<h2 id="appearance">Appearance</h2>
+<h2 id="preferences-appearance">Appearance</h2>
<ul>
<li>
</li>
</ul>
-<h2 id="video">Video</h2>
+<h2 id="preferences-video">Video</h2>
<ul>
<li>