Adding the new Patch selector doc

include/editing-clocks.html

@@ -39,12 +39,13 @@
 <p>
   New values for the clock can be typed in after clicking on the relevant clock.
   Clicking on the clock will show a thin vertical cursor bar just to the right
-  of the next character to be overwritten. Time should be typed in the same order as the
+  of the next character to be overwritten. Time should be typed in the same
-  current clock mode&mdash;if the clock is in Timecode mode, it should be
+  order as the current clock mode&mdash;if the clock is in Timecode mode, it
-  hours, minutes, seconds, frames. So, to change to a time of 12:15:20:15 one
+  should be hours, minutes, seconds, frames. So, to change to a time of
-  would type <kbd class="input">1 2 1 5 2 0 1 5</kbd>. Each number typed will
+  12:15:20:15 one would type
-  appear in a different color, from right to left, overwriting the existing value.
+  <kbd>1</kbd><kbd>2</kbd><kbd>1</kbd><kbd>5</kbd><kbd>2</kbd><kbd>0</kbd><kbd>1</kbd><kbd>5</kbd>.
-  Mid-edit, after typing <kbd class="input">3 2 2 2</kbd> the clock might look like this:
+  Each number typed will appear in a different color, from right to left,
+  overwriting the existing value. Mid-edit, after typing <kbd>3</kbd><kbd>2</kbd><kbd>2</kbd><kbd>2</kbd> the clock might look like this:
 </p>
 
 <figure>
@@ -82,13 +83,15 @@
   possible to enter part of a full time value.
 </p>
 <p>
-  As an exemple, supposing that the clock is in BBT
+  As an exemple, supposing that the clock is in BBT mode, displaying
-  mode, displaying <samp>024|03|0029</samp>, altering the value to
+  <samp>024|03|0029</samp>, altering the value to the first beat of the current
-  the first beat of the current bar can be done by clicking on the clock and typing
+  bar can be done by clicking on the clock and typing
-  <kbd class="input">0 1 0 0 0 0</kbd>. Similarly, if it is in Minutes:Seconds
+  <kbd>0</kbd><kbd>1</kbd><kbd>0</kbd><kbd>0</kbd><kbd>0</kbd><kbd>0</kbd>.
-  mode, displaying <samp>02:03:04.456</samp>, getting to exactly 2
+  Similarly, if it is in Minutes:Seconds mode, displaying
-  hours can be achieved by clicking on the clock and typing <kbd class="input">0 0 0 0 0 0 0</kbd> to
+  <samp>02:03:04.456</samp>, getting to exactly 2 hours can be achieved by
-  reset the minutes, seconds and milliseconds fields.
+  clicking on the clock and typing
+  <kbd>0</kbd><kbd>0</kbd><kbd>0</kbd><kbd>0</kbd><kbd>0</kbd><kbd>0</kbd><kbd>0</kbd>
+  to reset the minutes, seconds and milliseconds fields.
 </p>
 
 <h2>Entering Delta Times</h2>
@@ -100,8 +103,8 @@
   key will add the entered value to the current value of the clock, minus will
   subtract it. For example, if the clock is in Samples mode and displays
   <samp>2917839</samp>, moving it back 2000 samples is done by typing
-  <kbd class="input">2 0 0 0</kbd> and <kbd>-</kbd>, rather than ending with
+  <kbd>2</kbd><kbd>0</kbd><kbd>0</kbd><kbd>0</kbd> and <kbd>-</kbd>, rather than
-  Enter or Tab.
+  ending with <kbd>Enter</kbd> or <kbd>Tab</kbd>.
 </p>
 
 <h2>Changing clock values with the mouse</h2>
@@ -124,4 +127,3 @@
   on the clock, dragging downwards decreases it, again with a step size equal to
   the unit of the field where the drag began on.
 </p>
-

include/midi-track-controls.html

@@ -22,6 +22,9 @@
   <li>The <dfn>Scroomer</dfn>, a zoom and scroll controller for the midi notes range</li>
   <li>When the track is tall enough, the External MIDI Device selection dropdown appears.</li>
 </ol>
+
+<h2>The Scroomer</h2>
+
 <p>
   The Scroomer performs a couple of functions:
 </p>
@@ -35,6 +38,18 @@
     visible pitches fit the actual content of the track.</li>
   <li>Clicking on the piano plays the corresponding MIDI note for reference.</li>
 </ul>
+
+<h2>Channel and patch selection</h2>
+
+<h3>The Channel Selector</h3>
+
+<figure class="right">
+    <img class="mini" src="/images/midi_channel_control.png" alt="The MIDI channel control window">
+    <figcaption>
+      The MIDI channel control window
+    </figcaption>
+</figure>
+
 <p>
   A MIDI track's data may span any number of the 16 available MIDI channels, and sometimes it is
   useful to view only a subset of those channels; different instruments may,
@@ -42,7 +57,43 @@
   the <kbd class="menu">Channel Selector</kbd> allows to control the <dfn>MIDI channel</dfn>(s)
   that will be visible in the editor.
 </p>
+
+<p>
+  This window also gives control over which channel(s) will be recorded, and which will be played back, choosing between:
+</p>
+
+<ul>
+  <li>All channels</li>
+  <li>Only selected channels &mdash;Ardour then proposes to choose amongst the 16 channels which are to be recorded/played</li>
+  <li>Force all to one channel &mdash;Ardour then 'routes' all the channels to one user selectable channel.</li>
+</ul>
+
+<h3 class="clear">The Patch Selector</h3>
+
+<figure class="left">
+    <img class="mini" src="/images/patch_selector.png" alt="The Patch Selector window">
+    <figcaption>
+      The Patch Selector window
+    </figcaption>
+</figure>
+
+<p>
+  The Patch Selector window is an easy way to set which instrument will be used on any of the MIDI channels.
+  Although patches can be changed at any time using a <a href="@@patch-change">patch change</a>, this dialog
+  provides an easy and convenient way to preview patches in software and hardware instruments. It
+  integrates fully with Ardour's support for MIDNAM (patch definition files), so Ardour can display named programs/patches
+  for both General MIDI synths and those with MIDNAM files.
+</p>
+<p>
+  The window itself makes it easy to choose a channel, a bank number, optionnaly choosing a bank number through its <dfn title="Most Significant Byte">MSB</dfn>
+  and <dfn title="Least Significant Byte">LSB</dfn> numbers (CC#00 and CC#32) for large banks, then choosing an instrument.
+</p>
+<p>
+  The keyboard at the bottom of the window allows for a quick preview of the selected instrument, either automatically
+  (using the buttons on top of the keyboard) or manually by either clicking a note or using the computer keyboard as a
+  piano keyboard.
+</p>
+
 <p>
   To edit the contents of a MIDI track see <a href="@@edit-midi">MIDI Editing</a>.
 </p>
-