From: Paul Davis <paul@linuxaudiosystems.com>
Date: Mon, 4 May 2015 12:09:10 +0000 (-0400)
Subject: Merge branch 'hotguac-editprefs'
X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e01dfac1e75cae37db79f24eb765f17aa1faecdf;hp=2f92b02fbb5cb72b3e4f0d2495428a18d6b51df2;p=ardour-manual

Merge branch 'hotguac-editprefs'
---

diff --git a/_manual/21_preferences-and-session-properties/01_preferences-dialog.html b/_manual/21_preferences-and-session-properties/01_preferences-dialog.html
index 2d90c8a..32529c8 100644
--- a/_manual/21_preferences-and-session-properties/01_preferences-dialog.html
+++ b/_manual/21_preferences-and-session-properties/01_preferences-dialog.html
@@ -4,7 +4,11 @@ title: Global Preferences Dialog
 menu_title: Global Preferences
 ---                        
 
-  
-<img src="/files/a3/a3_ardour_preferences.png" alt="ardour preferences
+<p>
+  These preferences apply to all Ardour sessions.
+</p>
+
+<img src="/files/a4/a4_preferences_misc.png" alt="ardour preferences
 dialog"/>
   
+{% children %}
diff --git a/_manual/21_preferences-and-session-properties/01_preferences-dialog/01_misc.html b/_manual/21_preferences-and-session-properties/01_preferences-dialog/01_misc.html
new file mode 100644
index 0000000..0089089
--- /dev/null
+++ b/_manual/21_preferences-and-session-properties/01_preferences-dialog/01_misc.html
@@ -0,0 +1,149 @@
+---
+layout: default
+title: Misc Tab
+menu_title: Misc Tab
+---
+
+<p>
+  This tab contains settings that do not belong on the other tabs.
+</p>
+
+<img src="/files/a4/a4_preferences_misc.png" alt="preferences
+misc tab"/>
+
+<ul>
+  <li>
+    <p>
+      <strong>DSP CPU Utilization</strong> sets how many cpu processors can be
+      used to do signal processing. It can be set to use one up to all
+      processors.
+    </p>
+  </li>
+
+  <li>
+    <p>
+      <dfn>Undo</dfn>
+    </p>
+    <ul>
+      <li>
+	<p>
+	  <strong>Limit undo history</strong> sets how many commands can be
+	  undone using <kbd class="mod1">Z</kbd> or
+	  <kbd class="menu">Edit &gt; Undo</kbd>.
+	</p>
+      </li>
+
+      <li>
+	<p>
+	  <strong>Save undo history</strong> sets how many commands are saved so
+	  they are available to be undone after reopening the session.
+	</p>
+      </li>
+
+      <li>
+	<p>
+	  <strong>Verify removal of last capture</strong> when enabled prompts to
+	  verify removal the last recording capture when
+	  <kbd class="menu">Edit &gt; Remove Last Capture</kbd> is executed.
+	</p>
+      </li>
+
+      <li>
+	<p>
+	  <strong>Make periodic backups of the session file</strong> will create
+	  a backup session file after changes to the timeline. The backup file is
+	  the session name followed by <em>.ardour.bak</em>. The backup can be
+	  used to recover from crashes when the session had not been explicitly
+	  saved.
+	</p>
+      </li>
+    </ul>
+  </li>
+
+  <li>
+    <p>
+      <dfn>Session Management</dfn>
+    </p>
+    <ul>
+      <li>
+	<p>
+	  <strong>Always copy imported files</strong> selects, and then disables
+	  changes to, the <em>Copy&nbsp;files to&nbsp;session</em> option in the
+	  <a href="/adding-pre-existing-material/import-dialog/">
+	    Add Existing Media</a> dialog.
+	</p>
+      </li>
+
+      <li>
+	<p>
+	  <strong>Default folder for new sessions:</strong> defalts the folder
+	  where Ardour will create new session folders. This is used in the
+	  <em>Session&nbsp;Setup</em> dialog displayed by
+	  <kbd class="menu">Session &gt; New</kbd>.
+	</p>
+      </li>
+
+      <li>
+	<p>
+	  <strong>Maximum number of recent sessions:</strong> determines how many
+	  of the last opened sessions shows in the
+	  <em>Recent&nbsp;Sessions</em> dialog displayed by
+	  <kbd class="menu">Session &gt; Recent</kbd>.
+	</p>
+      </li>
+    </ul>
+  </li>
+
+  <li>
+    <p>
+      <dfn>Click</dfn>
+    </p>
+    <ul>
+      <li>
+	<p>
+	  <strong>Click audio file:</strong> sets a user defined sound to be
+	  played when Ardour's metronome is enabled in the
+	  <a href="/controlling-playback/using-the-transport-bar/">
+	    Transport Bar</a>
+	</p>
+      </li>
+      <li>
+	<p>
+          <strong>Click emphasis audio file:</strong> sets an optional different
+	  metronome sound to be played on the downbeat.
+	</p>
+      </li>
+      <li>
+	<p>
+          <strong>Click gain level:</strong> allows the metronome's click sounds
+	  to be boosted or attenuated.
+	</p>
+      </li>
+    </ul>
+  </li>
+
+  <li>
+    <p>
+      <dfn>Automation</dfn>
+    </p>
+    <ul>
+      <li>
+	<p>
+	  <strong>Thinning factor</strong> ranges from 0 to 1000 with larger
+	  values sending fewer automation changes. Thinning is like lossy
+	  audio compression, removing data that is less likely to be noticed,
+	  although the more you remove the more likely the loss will be noticed.
+	  The advantage to thinning is reduced CPU usage.
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Automation sampling interval</strong> ranges from 1 to
+	  1000&nbsp;ms. Determines how frequently the automation input is
+	  sampled. The shorter the interval the higher the accuracy but also
+	  the higher the CPU requirements.
+	</p>
+      </li>
+    </ul>
+
+</ul>
diff --git a/_manual/21_preferences-and-session-properties/01_preferences-dialog/02_transport.html b/_manual/21_preferences-and-session-properties/01_preferences-dialog/02_transport.html
new file mode 100644
index 0000000..1d1f8fd
--- /dev/null
+++ b/_manual/21_preferences-and-session-properties/01_preferences-dialog/02_transport.html
@@ -0,0 +1,177 @@
+---
+layout: default
+title: Transport Tab
+menu_title: Transport Tab
+---
+
+<p>
+  This tab contains settings that relate to the behavior of the
+  <a href="/controlling-playback/using-the-transport-bar">Transport Bar</a>
+  and <a href="/synchronization/">Synchronization</a>.
+</p>
+
+<img src="/files/a4/a4_preferences_transport.png" alt="preferences
+transport tab"/>
+
+<ul>
+  <li>
+    <p>
+      <strong>Keep record-enable engaged on stop</strong> leaves the global
+      record-enable engaged after transport is stopped.  Does not affect track
+      level record-enable which is never changed on stop.
+    </p>
+  </li>
+
+  <li>
+    <p>
+      <strong>Play loop is a transport mode</strong> changes the behavior of the
+      loop button, turning it into a toggle. When enabled, the loop button does
+      not start playback but forces playback to always play the loop.  Looping
+      stays engaged when the transport is stopped. Playback continues where the
+      transport stopped and continues to loop.
+    </p>
+    <p>
+      When disabled, the loop button starts playing the loop but stop then
+      cancels loop playback.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Stop recording when an xrun occurs</strong> will stop the transport
+      when an xrun occurs during recording, ensuring no audible glitches are
+      recorded.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Create markers where xruns occur</strong> will create a new
+      <a href="/working-with-markers/">marker</a> when an xrun occurs during
+      recording at the location of the xrun. This marks where possible xruns
+      might produce audible glitches when stopping on xruns is disabled.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Stop at the end of the session</strong> causes the transport to
+      stop during playback when it reaches the end marker. Behavior during
+      recording is not changed.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Do seamless looping</strong> removes any clicks that might
+      otherwise be audible when the transport moves from the end of the loop
+      range back to the beginning.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Disable per-track record disarm while rolling</strong>, when
+      enabled, will not allow the any track's record-enable to be disarmed
+      during record, preventing accidentally stopping the recording of a take.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>12dB gain reduction during fast-forward and fast-rewind</strong>
+      when enabled will reduce the unpleasant increase in perceived volume
+      that occurs when fast-forwarding or rewinding through some kinds of audio.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Sync/Slave</strong>
+      <ul>
+	<li>
+	  <p>
+	    <strong>External timecode source</strong> determines which external
+	    source to use when Ardour is using an external
+	    <a href="/synchronization/">synchronization</a> source.  Depending
+	    on the timecode source chosen, additional preference options are
+	    available.
+	  </p>
+	</li>
+	<li>
+	  <p>
+	    <strong>Match session video frame rate to external timecode</strong>
+	    controls the value of the video frame rate <em>while chasing</em>
+	    an external timecode source.
+	  </p>
+	  <p>
+	    When enabled, the session video frame rate will be changed to match
+	    that of the selected external timecode source.
+	  </p>
+	  <p>
+	    When disabled, the session video frame rate will not be changed to
+	    match that of the selected external timecode source. Instead, the
+	    frame rate indication in the main clock will flash red and Ardour
+	    will convert between the external timecode standard and the session
+	    standard.
+	  </p>
+	</li>
+	<li>
+	  <p>
+	    <strong>Sync-lock timecode to clock</strong> can disable drift
+	    compensation.
+	  </p>
+	  <p>
+	    When enabled, Ardour will never varispeed when slaved to external
+	    timecode. Sync Lock indicates that the selected external timecode
+	    source shares clock-sync (Black &amp; Burst, Wordclock, etc) with
+	    the audio interface. This options disables drift compensation.
+	    The transport speed is fixed at 1.0. Vari-speed LTC will be ignored
+	    and cause drift.
+	  </p>
+	  <p>
+	    When disabled, Ardour will compensate for potential drift regardless
+	    if the timecode sources shares clock sync.
+	  </p>
+	</li>
+	<li>
+	  <p>
+	    <strong>Lock to 29.9700 fps instead of 30000/1001</strong>, when
+	    enabled, will force Ardour to assume the external timecode source
+	    uses 29.97 fps instead of 30000/1001.
+	    SMPTE 12M-1999 specifies 29.97&nbsp;df as 30000/1001. The spec
+	    further mentions that drop-frame timecode has an accumulated error
+	    of -86&nbsp;ms over a 24&nbsp;hour period. Drop-frame timecode would
+	    compensate exactly for an NTSC color frame rate of 30 * 0.9990 (i.e.
+	    29.970000). That is not the actual rate. However, some vendors use
+	    that rate - despite it being against the specs - because the
+	    variant of using exactly 29.97&nbsp;fps has zero timecode drift.
+	  </p>
+      </ul>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>LTC Reader</strong> specifies which incoming port will provide
+      the LTC signal.
+    </p>
+  </li>
+  <li>
+    <strong>LTC Generator</strong>
+    <ul>
+      <li>
+	<p>
+	  <strong>Enable LTC generator</strong>, when enabled Ardour will
+	  output an LTC timecode signal on it's <em>LTC-out</em> port.
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Send LTC while stopped</strong>, when enabled Ardour will
+	  continue to send LTC information even while the transport (playhed) is
+	  not moving.
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>LTC generator level:</strong> specifies the peak volume of
+	  the generated LTC signal in dbFS. A good value is 0dBu^=-18dbFS in an
+	  EBU calibrated system.
+	</p>
+      </li>
+    </ul>
+  </li>
+</ul>
diff --git a/_manual/21_preferences-and-session-properties/01_preferences-dialog/03_editor.html b/_manual/21_preferences-and-session-properties/01_preferences-dialog/03_editor.html
new file mode 100644
index 0000000..ac32da7
--- /dev/null
+++ b/_manual/21_preferences-and-session-properties/01_preferences-dialog/03_editor.html
@@ -0,0 +1,152 @@
+---
+layout: default
+title: Editor Tab
+menu_title: Editor Tab
+---
+
+<p>
+  This tab contains settings that affect behavior in the <dfn>Editor</dfn>
+  window when <a href="/editing-and-arranging">Editing and Arranging</a>.
+</p>
+
+<img src="/files/a4/a4_preferences_editor.png" alt="preferences
+editor tab"/>
+
+<ul>
+  <li>
+    <p>
+      <strong>Allow dragging of the playhead</strong>, when enabled, allows
+      dragging the playhead with the mouse in the <strong>Editor</strong> window.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Move relevant automation when audio regions are moved</strong>,
+      when enabled, causes automation data to stay with a region when the
+      region is moved inside the playlist. When disabled, the automation is
+      not affected by movement of regions.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Show meters on tracks in the editor</strong>, when enabled, shows
+      a small meter in the <strong>Editor</strong> window with each track. The
+      meter is shown in the left side area along with the track name and buttons.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Display master-meter in the toolbar</strong> when enabled displays
+      a small copy of the master bus meter in the toolbar.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Default fade shape:</strong> sets which
+      <a href="/editing-and-arranging/create-region-fades-and-crossfades/">
+	fade shape</a> is the default.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Regions in active edit groups are edited together:</strong> sets
+      the criteria to see if editing actions apply to tracks grouped together
+      in an active group.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Make rubberband selection rectangle snap to the grid</strong> when
+      enabled uses the grid when
+      <a href="/editing-and-arranging/select-regions/">selecting regions</a>
+      with a rubberband rectangle.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Show waveforms in regions</strong> when enabled shows a visual
+      representation of the region's audio waveform. Changes to this setting
+      take affect after restarting Ardour.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Show gain envelopes in audio regions:</strong> sets the criteria
+      for displaying the gain envelope in audio regions.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Waveform scale:</strong> when waveforms are shown in audio region
+      they can be displayed using a <em>linear</em> or a <em>logarithmic</em>
+      scale.
+      See <a href="/working-with-tracks/controlling-track-appearance/waveform-display/">
+	Waveform disply</a>.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Waveform shape:</strong> when waveforms are shown in audio region
+      they can be displayed using a <em>traditional</em> or a <em>rectified</em>
+      shape.
+      See <a href="/working-with-tracks/controlling-track-appearance/waveform-display/">
+	Waveform disply</a>.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Waveform Clip Level (dBFS):</strong> sets the level at which the
+      waveform shown in an audio region will be drawn in red to indicate
+      clipping. Setting lower than 0.0&nbsp;dBFS can be useful if any tool in
+      the audio chain has problems near 0.0&nbsp;dBFS.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Show waveform for audio while it is being recorded</strong> when
+      enabled, will draw the audio waveform in regions being recorded.  When
+      disabled only a region block will be drawn while recording reducing CPU
+      requirements.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Show zoom toolbar</strong> when enabled shows a toolbar for
+      zoom functions.  When disabled the zoom commands are still available
+      with keyboard short-cuts and the View menu. Changes to this setting
+      take affect after restarting Ardour.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Update editor window during drags of the summary</strong> when
+      enabled the contents of the editor window will redraw the tracks area
+      as the selection rectangle in the summary area is moved or resized. The
+      summary area is at the bottom of the editor and shows an overview of all
+      regions on the timelime.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Name new markers</strong> when enabled, popup a dialog when a new
+      <a href="/working-with-markers/">marker</a> is created. This allows
+      markers to be named as they are created.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Auto-scroll editor window when dragging near its edges</strong>
+      when enabled will scroll the editor window automatically when dragging a
+      region. This can make it easier to see where to position the region.
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>After splitting selected regions, select</strong> determines which,
+      if any, regions are selected after a split operation. The options are no
+      regions, the regions created by the split, and if more than one region
+      was selected to start with, the existing selection and the new regions.
+      Changes to this setting take affect after restarting Ardour.
+    </p>
+  </li>
+</ul>
diff --git a/_manual/21_preferences-and-session-properties/01_preferences-dialog/04_audio.html b/_manual/21_preferences-and-session-properties/01_preferences-dialog/04_audio.html
new file mode 100644
index 0000000..2ff3615
--- /dev/null
+++ b/_manual/21_preferences-and-session-properties/01_preferences-dialog/04_audio.html
@@ -0,0 +1,152 @@
+---
+layout: default
+title: Audio Tab
+menu_title: Audio Tab
+---
+
+<p>
+  This tab contains settings for handling audio.
+</p>
+
+<img src="/files/a4/a4_preferences_audio.png" alt="preferences
+audio tab"/>
+
+<ul>
+
+  <li>
+    <p>
+      <strong>Buffering</strong> settings determine how many seconds of audio
+      off of disk will be buffered in memory. Longer settings reduce the risk
+      of buffer under-runs but consume more memory. The default value is
+      5.0&nbsp;seconds.
+    </p>
+
+    <ul>
+      <li>
+	<p>
+	  <strong>Playback</strong> sets how many seconds of audio Ardour will
+	  buffer during playback.
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Recording</strong> sets how many seconds of audio Ardour will
+	  buffer during recording.
+	</p>
+      </li>
+    </ul>
+  </li>
+
+  <li>
+    <p>
+      <strong>Monitoring</strong>
+    </p>
+    <ul>
+      <li>
+	<p>
+	  <strong>Record monitoring handled by:</strong> determines whether
+	  Ardour provides monitoring of incoming audio or whether
+	  monitoring is provided by hardware.  See
+	  <a href="/recording/monitoring/">Monitoring</a> for more information.
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Tape machine mode</strong> when enabled defaults new audio
+	  tracks to tape machine mode. See
+	  <a href="/working-with-tracks/track-types/">Track Types</a>
+	  for more information.
+	</p>
+      </li>
+    </ul>
+  </li>
+
+  <li>
+    <p>
+    <strong>Conection of tracks and busses</strong>
+    </p>
+    <ul>
+      <li>
+	<p>
+	  <strong>Auto-connect master/monitor busses</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Connect track inputs:</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Connect track and bus outputs:</strong>
+	</p>
+      </li>
+    </ul>
+  </li>
+
+  <li>
+    <p>
+    <strong>Denormals</strong> are a specific type of very small numbers that
+    can cause issues with CPU consumption when using some plugins in some
+    circumstances.
+    </p>
+    <p>
+      Ardour provides two methods of handling the issue. Try different
+      combinations of these settings to to find the setting that minimizes CPU
+      consumption.
+    </p>
+    <ul>
+      <li>
+	<p>
+	  <strong>Use DC bias to protect against denormals</strong> adds a small
+	  constant value to numbers to move the numbers away from zero.
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Processor handling</strong>, if the computer's hardware
+	  supports it, offers two methods that can be used individually or
+	  combined. Flush to zero and denormals are zero.
+	</p>
+      </li>
+    </ul>
+  </li>
+
+  <li>
+    <p>
+    <strong>Plugins</strong>
+    </p>
+    <ul>
+      <li>
+	<p>
+	  <strong>Silence plugins when the transport is stopped</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Make new plugins active</strong> when enabled, will activate
+	  a plugin when it is added to a track or buss
+	  <a href="/working-with-plugins/processor-box/">Processor Box</a>.
+	</p>
+      </li>
+    </ul>
+  </li>
+
+  <li>
+    <p>
+    <strong>Regions</strong>
+    </p>
+    <ul>
+      <li>
+	<p>
+	  <strong>Enable automatic analysis of audio</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Replicate missing region channels</strong>
+	</p>
+      </li>
+    </ul>
+  </li>
+</ul>
diff --git a/_manual/21_preferences-and-session-properties/01_preferences-dialog/05_solomute.html b/_manual/21_preferences-and-session-properties/01_preferences-dialog/05_solomute.html
new file mode 100644
index 0000000..b6c0592
--- /dev/null
+++ b/_manual/21_preferences-and-session-properties/01_preferences-dialog/05_solomute.html
@@ -0,0 +1,103 @@
+---
+layout: default
+title: Solo/Mute Tab
+menu_title: Solo/Mute Tab
+---
+
+<p>
+  This tab contains settings that affect the use of solo, muting, and panning.
+</p>
+
+<img src="/files/a4/a4_preferences_solomute.png" alt="preferences
+solo/mute tab"/>
+
+<ul>
+  <li>
+    <p>
+      <strong>Solo</strong>
+    </p>
+    <ul>
+      <li>
+	<p>
+	  <strong>Solo-in-place mute cut</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Solo controls are Listen controls</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Listen Position:</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>PFL signals come from:</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>AFL signals come from:</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Exclusive solo</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Show solo muting</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Soloing overrides muting</strong>
+	</p>
+      </li>
+    </ul>
+  </li>
+
+  <li>
+    <p>
+      <strong>Default track/bus muting options</strong>
+    </p>
+    <ul>
+      <li>
+	<p>
+	  <strong>Mute affects pre-fader sends</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Mute affects post-fader sends</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Mute affects control outputs</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Mute affects main outputs</strong>
+	</p>
+      </li>
+    </ul>
+  </li>
+
+  <li>
+    <p>
+      <strong>Send Routing</strong>
+    </p>
+    <ul>
+      <li>
+	<p>
+	  <strong>Link panners of Aux and External Sends with main panner by default</strong>
+	</p>
+      </li>
+    </ul>
+  </li>
+</ul>
diff --git a/_manual/21_preferences-and-session-properties/01_preferences-dialog/06_midi.html b/_manual/21_preferences-and-session-properties/01_preferences-dialog/06_midi.html
new file mode 100644
index 0000000..97ecbab
--- /dev/null
+++ b/_manual/21_preferences-and-session-properties/01_preferences-dialog/06_midi.html
@@ -0,0 +1,99 @@
+---
+layout: default
+title: MIDI Tab
+menu_title: MIDI Tab
+---
+
+<p>
+  This tab contains settings related to the use of MIDI inside Ardour.
+</p>
+
+<img src="/files/a4/a4_preferences_midi.png" alt="preferences
+MIDI tab"/>
+
+<ul>
+  <li>
+    <p>
+      <strong>MIDI read-ahead time</strong>
+    </p>
+  </li>
+
+  <li>
+    <p>
+      <strong>Send MIDI Clock</strong>
+    </p>
+  </li>
+
+  <li>
+    <p>
+      <strong>Send MIDI Time Code</strong>
+    </p>
+  </li>
+
+  <li>
+    <p>
+      <strong>Percentage either side of normal transport speed to transmit MTC:</strong>
+    </p>
+  </li>
+
+  <li>
+    <p>
+      <strong>Obey MIDI Machine Control commands</strong>
+    </p>
+  </li>
+
+  <li>
+    <p>
+      <strong>Send MIDI Machine Control commands</strong>
+    </p>
+  </li>
+
+  <li>
+    <p>
+      <strong>Send MIDI control feedback</strong>
+    </p>
+  </li>
+
+  <li>
+    <p>
+      <strong>Inbound MMC device ID:</strong>
+    </p>
+  </li>
+
+  <li>
+    <p>
+      <strong>Outbound MMC device ID:</strong>
+    </p>
+  </li>
+
+  <li>
+    <p>
+      <strong>Initial program change:</strong>
+    </p>
+  </li>
+
+  <li>
+    <p>
+      <strong>Display first MIDI bank/program as 0</strong>
+    </p>
+  </li>
+
+  <li>
+    <p>
+      <strong>Never display periodic MIDI messages</strong>
+    </p>
+  </li>
+
+  <li>
+    <p>
+      <strong>Sound MIDI notes as they are selected</strong>
+    </p>
+  </li>
+
+  <li>
+    <p>
+      <strong>Midi Audition Synth</strong>
+    </p>
+  </li>
+
+</ul>
diff --git a/_manual/21_preferences-and-session-properties/01_preferences-dialog/07_interaction.html b/_manual/21_preferences-and-session-properties/01_preferences-dialog/07_interaction.html
new file mode 100644
index 0000000..95d5c99
--- /dev/null
+++ b/_manual/21_preferences-and-session-properties/01_preferences-dialog/07_interaction.html
@@ -0,0 +1,53 @@
+---
+layout: default
+title: User Interaction Tab
+menu_title: User Interaction Tab
+---
+
+<p>
+  This tab contains settings that affect the user's interaction with
+  <a href="/ardours-interface">Ardours interface</a>.
+</p>
+
+<img src="/files/a4/a4_preferences_interaction.png" alt="preferences
+user interaction tab"/>
+
+<ul>
+  <li>
+    <p>
+      <strong>Use translations</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Keyboard</strong>
+    </p>
+    <ul>
+      <li>
+	<p>
+	  <strong>Edit using:</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Delete using:</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Insert note using</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Ignore snap using:</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Keyboard layout:</strong>
+	</p>
+      </li>
+    </ul>
+  </li>
+</ul>
diff --git a/_manual/21_preferences-and-session-properties/01_preferences-dialog/08_control_surfaces.html b/_manual/21_preferences-and-session-properties/01_preferences-dialog/08_control_surfaces.html
new file mode 100644
index 0000000..57587e9
--- /dev/null
+++ b/_manual/21_preferences-and-session-properties/01_preferences-dialog/08_control_surfaces.html
@@ -0,0 +1,24 @@
+---
+layout: default
+title: Control Surfaces Tab
+menu_title: Control Surfaces Tab
+---
+
+<p>
+  This tab contains settings for control surfaces. Also see
+  <a href="/using-control-surfaces/">Using Control Surfaces</a>.
+</p>
+
+<img src="/files/a4/a4_preferences_control_surfaces.png" alt="preferences
+control surfaces tab"/>
+
+<p>
+  Enable a <dfn>Control Surface Protocol</dfn> and double-click on it to edit
+  protocol specific  settings. Enable feedback to allow Ardour to send position
+  information back to a control surface.
+</p>
+
+<p>
+  <strong>Control surface remote ID:</strong> can follow the order of the mixer
+  or be user assigned.
+</p>
diff --git a/_manual/21_preferences-and-session-properties/01_preferences-dialog/09_video.html b/_manual/21_preferences-and-session-properties/01_preferences-dialog/09_video.html
new file mode 100644
index 0000000..edb50bb
--- /dev/null
+++ b/_manual/21_preferences-and-session-properties/01_preferences-dialog/09_video.html
@@ -0,0 +1,42 @@
+---
+layout: default
+title: Video Tab
+menu_title: Video Tab
+---
+
+<p>
+  This tab contains settings related to handling of Video.
+</p>
+
+<img src="/files/a4/a4_preferences_video.png" alt="preferences
+video tab"/>
+
+<ul>
+  <li>
+    <p>
+      <strong>Advanced Setup (remote video server)</strong>
+    </p>
+    <ul>
+      <li>
+	<p>
+	  <strong>Video Server URL:</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Video Folder:</strong>
+	</p>
+      </li>
+    </ul>
+  </li>
+  <li>
+    <p>
+      <strong>Show Video Export Info before export</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Show Video Server Startup Dialog</strong>
+    </p>
+  </li>
+</ul>
diff --git a/_manual/21_preferences-and-session-properties/01_preferences-dialog/10_plugins.html b/_manual/21_preferences-and-session-properties/01_preferences-dialog/10_plugins.html
new file mode 100644
index 0000000..522b773
--- /dev/null
+++ b/_manual/21_preferences-and-session-properties/01_preferences-dialog/10_plugins.html
@@ -0,0 +1,65 @@
+---
+layout: default
+title: Plugins Tab
+menu_title: Plugins Tab
+---
+
+<p>
+  This tab contains settings that do not belong on the other tabs.
+</p>
+
+<img src="/files/a4/a4_preferences_plugins.png" alt="preferences
+plugins tab"/>
+
+<ul>
+  <li>
+    <p>
+      <strong>General</strong>
+    </p>
+    <ul>
+      <li>
+	<p>
+	  <strong>Scan for Plugins</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Allow Display Plugin Scan Progress</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Scan Time Out</strong>
+	</p>
+      </li>
+    </ul>
+  </li>
+
+  <li>
+    <p>
+      <strong>VST</strong>
+    </p>
+    <ul>
+      <li>
+	<p>
+	  <strong>Clear VST Cache</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Clear VST Blacklist</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Scan for [new] VST Plugins on Application Start</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Linux VST Path:</strong>
+	</p>
+      </li>
+    </ul>
+  </li>
+</ul>
diff --git a/_manual/21_preferences-and-session-properties/01_preferences-dialog/11_gui.html b/_manual/21_preferences-and-session-properties/01_preferences-dialog/11_gui.html
new file mode 100644
index 0000000..b0714db
--- /dev/null
+++ b/_manual/21_preferences-and-session-properties/01_preferences-dialog/11_gui.html
@@ -0,0 +1,83 @@
+---
+layout: default
+title: GUI Tab
+menu_title: GUI Tab
+---
+
+<p>
+  This tab contains settings that affect
+  <a href="/ardours-interface/">Ardour's Interface</a>.
+</p>
+
+<img src="/files/a4/a4_preferences_gui.png" alt="preferences
+gui tab"/>
+
+<ul>
+  <li>
+    <p>
+      <strong>Graphically indicate mouse pointer hovering</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Use name highlight bars in region display</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Font scaling</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Update transport clock display at FPS</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Lock timeout</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Mixer Strip</strong>
+    </p>
+    <ul>
+      <li>
+	<p>
+	  <strong>Input</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Phase Invert</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Record &amp; Monitor</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Solo Iso/Lock</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Output</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Comments</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Use narrow strips in the mixer by default</strong>
+	</p>
+      </li>
+    </ul>
+  </li>
+</ul>
diff --git a/_manual/21_preferences-and-session-properties/01_preferences-dialog/12_metering.html b/_manual/21_preferences-and-session-properties/01_preferences-dialog/12_metering.html
new file mode 100644
index 0000000..18c8114
--- /dev/null
+++ b/_manual/21_preferences-and-session-properties/01_preferences-dialog/12_metering.html
@@ -0,0 +1,50 @@
+---
+layout: default
+title: Metering Tab
+menu_title: Metering Tab
+---
+
+<p>
+  This tab contains settings that affect the display and behavior of meters.
+</p>
+
+<img src="/files/a4/a4_preferences_metering.png" alt="preferences
+metering tab"/>
+
+<ul>
+  <li>
+    <p>
+      <strong>Peak hold time:</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>DPM fall-off:</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Meter line-up level; 0&nbsp;dBu:</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>IEC1/DIN Meter line-up level; 0&nbsp;dBu:</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>VU Meter standard:</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Peak threshold[dBFS]:</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>LED meter style</strong>
+    </p>
+  </li>
+</ul>
diff --git a/_manual/21_preferences-and-session-properties/01_preferences-dialog/13_theme.html b/_manual/21_preferences-and-session-properties/01_preferences-dialog/13_theme.html
new file mode 100644
index 0000000..3599ba3
--- /dev/null
+++ b/_manual/21_preferences-and-session-properties/01_preferences-dialog/13_theme.html
@@ -0,0 +1,87 @@
+---
+layout: default
+title: Theme Tab
+menu_title: Theme Tab
+---
+
+<p>
+  This tab contains settings that change the visual appearence of Ardour.
+</p>
+
+<img src="/files/a4/a4_preferences_theme.png" alt="preferences
+theme tab"/>
+
+<ul>
+  <li>
+    <p>
+      <strong>Restore Defaults</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>All floating windows are dialogs</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Transient windows follow front window</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Draw &quot;flat&quot; buttons</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Blink Rec-Arm buttons</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Color regions using their track's color</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Show waveform clipping</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Icon Set</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Waveforms color gradient depth</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Timeline item gradient depth</strong>
+    </p>
+  </li>
+  <li>
+    <p>
+      <strong>Colors</strong>
+    </p>
+    <ul>
+      <li>
+	<p>
+	  <strong>Items</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Palette</strong>
+	</p>
+      </li>
+      <li>
+	<p>
+	  <strong>Transparency</strong>
+	</p>
+      </li>
+    </ul>
+  </li>
+</ul>
diff --git a/source/files/a4/a4_preferences_audio.png b/source/files/a4/a4_preferences_audio.png
new file mode 100644
index 0000000..c6e16ed
Binary files /dev/null and b/source/files/a4/a4_preferences_audio.png differ
diff --git a/source/files/a4/a4_preferences_control_surfaces.png b/source/files/a4/a4_preferences_control_surfaces.png
new file mode 100644
index 0000000..ab776eb
Binary files /dev/null and b/source/files/a4/a4_preferences_control_surfaces.png differ
diff --git a/source/files/a4/a4_preferences_editor.png b/source/files/a4/a4_preferences_editor.png
new file mode 100644
index 0000000..af82d5e
Binary files /dev/null and b/source/files/a4/a4_preferences_editor.png differ
diff --git a/source/files/a4/a4_preferences_gui.png b/source/files/a4/a4_preferences_gui.png
new file mode 100644
index 0000000..cc0531f
Binary files /dev/null and b/source/files/a4/a4_preferences_gui.png differ
diff --git a/source/files/a4/a4_preferences_interaction.png b/source/files/a4/a4_preferences_interaction.png
new file mode 100644
index 0000000..96c5e51
Binary files /dev/null and b/source/files/a4/a4_preferences_interaction.png differ
diff --git a/source/files/a4/a4_preferences_metering.png b/source/files/a4/a4_preferences_metering.png
new file mode 100644
index 0000000..f65d22a
Binary files /dev/null and b/source/files/a4/a4_preferences_metering.png differ
diff --git a/source/files/a4/a4_preferences_midi.png b/source/files/a4/a4_preferences_midi.png
new file mode 100644
index 0000000..6f4eec0
Binary files /dev/null and b/source/files/a4/a4_preferences_midi.png differ
diff --git a/source/files/a4/a4_preferences_misc.png b/source/files/a4/a4_preferences_misc.png
new file mode 100644
index 0000000..e6fd8ba
Binary files /dev/null and b/source/files/a4/a4_preferences_misc.png differ
diff --git a/source/files/a4/a4_preferences_plugins.png b/source/files/a4/a4_preferences_plugins.png
new file mode 100644
index 0000000..1b96c5d
Binary files /dev/null and b/source/files/a4/a4_preferences_plugins.png differ
diff --git a/source/files/a4/a4_preferences_solomute.png b/source/files/a4/a4_preferences_solomute.png
new file mode 100644
index 0000000..633640d
Binary files /dev/null and b/source/files/a4/a4_preferences_solomute.png differ
diff --git a/source/files/a4/a4_preferences_theme.png b/source/files/a4/a4_preferences_theme.png
new file mode 100644
index 0000000..3039beb
Binary files /dev/null and b/source/files/a4/a4_preferences_theme.png differ
diff --git a/source/files/a4/a4_preferences_transport.png b/source/files/a4/a4_preferences_transport.png
new file mode 100644
index 0000000..b446517
Binary files /dev/null and b/source/files/a4/a4_preferences_transport.png differ
diff --git a/source/files/a4/a4_preferences_video.png b/source/files/a4/a4_preferences_video.png
new file mode 100644
index 0000000..0e8d0b7
Binary files /dev/null and b/source/files/a4/a4_preferences_video.png differ