From: Joe Kokosa <hotguac@comcast.net>
Date: Sat, 2 May 2015 12:42:53 +0000 (-0400)
Subject: Updated and added content
X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b4368a9d4c8a390a9a47529527dab2a3503d11d0;p=ardour-manual

Updated and added content
---

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
index 587e433..0089089 100644
--- 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
@@ -13,61 +13,83 @@ misc tab"/>
 
 <ul>
   <li>
-    DSP CPU Utilization sets how many cpu processors can be used to do signal
-    processing. It can be set to use one up to all processors.
+    <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>
-    <dfn>Undo</dfn>
+    <p>
+      <dfn>Undo</dfn>
+    </p>
     <ul>
       <li>
-	<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>
+	  <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>
-	<strong>Save undo history</strong> sets how many commands are saved so
-	they are available to be undone after reopening the session.
+	<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>
-	<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>
+	  <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>
-	<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>
+	  <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>
-    <dfn>Session Management</dfn>
+    <p>
+      <dfn>Session Management</dfn>
+    </p>
     <ul>
       <li>
-	<strong>Always copy imported files</strong> selects, and then disables,
-	the <em>Copy files to session</em> option in the
-	<a href="/adding-pre-existing-material/import-dialog/">
-	  Add Existing Media</a> dialog.
+	<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>
-	<strong>Default folder for new sessions:</strong> defalts the folder
-	where Ardour will create new session folders. This is used in the
-	<em>Session Setup</em> dialog displayed by
-	<kbd class="menu">Session &gt; New</kbd>.
+	<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>
-	<strong>Maximum number of recent sessions:</strong> determines how many
-	of the last opened sessions shows in the <em>Recent Sessions</em> dialog
-	displayed by <kbd class="menu">Session &gt; Recent</kbd>.
+	<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>
@@ -78,36 +100,49 @@ misc tab"/>
     </p>
     <ul>
       <li>
-	<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>
+	  <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>
-        <strong>Click emphasis audio file:</strong> sets an optional different
-	sound to be played on the metronome's downbeat.
+	<p>
+          <strong>Click emphasis audio file:</strong> sets an optional different
+	  metronome sound to be played on the downbeat.
+	</p>
       </li>
       <li>
-        <strong>Click gain level:</strong> allows the metronome's click sounds
-	to be boosted or attenuated.
+	<p>
+          <strong>Click gain level:</strong> allows the metronome's click sounds
+	  to be boosted or attenuated.
+	</p>
       </li>
     </ul>
   </li>
 
-  <li><dfn>Automation</dfn>
+  <li>
+    <p>
+      <dfn>Automation</dfn>
+    </p>
     <ul>
       <li>
-	<strong>Thinning factor</strong> ranges from 0 to 1000 with larger
-	values storing fewer automation points. Thinning is like lossy
-	audio compression, removing data that is less likely to be noticed,
-	although the more you remove the more noticable the loss is. The
-	advantage to thinning is it reduces CPU requirements.
+	<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>
-	<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>
+	  <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>
 
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
index e87b427..167233a 100644
--- 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
@@ -21,6 +21,7 @@ transport tab"/>
       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
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
index 7fa1ff2..ac32da7 100644
--- 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
@@ -36,77 +36,117 @@ editor tab"/>
   </li>
   <li>
     <p>
-      <strong>Display master-meter in the toolbar</strong>
+      <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>
+      <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>
+      <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>
+      <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>
+      <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>
+      <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>
+      <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>
+      <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>
+      <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>
+      <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>
+      <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>
+      <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>
+      <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>
+      <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
index fff6ebc..9d575d9 100644
--- 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
@@ -86,17 +86,27 @@ audio tab"/>
 
   <li>
     <p>
-    <strong>Denormals</strong>
+    <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>
+	  <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>
+	  <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>