From 5da66b5be2653e3548c2ca5338754c75c4627cac Mon Sep 17 00:00:00 2001
From: Paul Davis <paul@linuxaudiosystems.com>
Date: Thu, 14 Mar 2013 16:58:12 -0400
Subject: [PATCH] new page on MIDI learn, and x-link from binding maps page

---
 .../03_midi-binding-maps.html                 | 13 ++++++-
 .../04_midi_learn.html                        | 39 +++++++++++++++++++
 2 files changed, 51 insertions(+), 1 deletion(-)
 create mode 100644 _manual/22_using-control-surfaces/04_midi_learn.html

diff --git a/_manual/22_using-control-surfaces/03_midi-binding-maps.html b/_manual/22_using-control-surfaces/03_midi-binding-maps.html
index eabaa95..5ce8a80 100644
--- a/_manual/22_using-control-surfaces/03_midi-binding-maps.html
+++ b/_manual/22_using-control-surfaces/03_midi-binding-maps.html
@@ -7,7 +7,18 @@ title: MIDI Binding Maps
   
   
 <p>
-Ardour 2.X supported <a href="/generic_midi_control">MIDI learning</a> for more or less any control. This was a nice feature that quite a few other DAWs have now provided, but it didn't allow Ardour to work "out of the box" with sensible defaults for existing commercial MIDI controllers. In Ardour 3 and later versions, we have augmented the MIDI learn feature with the ability to load a MIDI binding map for a given controller, which can set up an arbitrary number of physical controls with anything inside Ardour that can be controlled. At this time, these binding maps need to be created with a text editor, but we currently have presets for </p>
+Ardour 2.X supported <a href="midi_learn">MIDI learning</a> for more
+or less any control. This was a nice feature that quite a few other
+DAWs have now provided, but it didn't allow Ardour to work "out of the
+box" with sensible defaults for existing commercial MIDI
+controllers. In Ardour 3 and later versions, we have augmented the
+MIDI learn feature with the ability to load a MIDI binding map for a
+given controller, which can set up an arbitrary number of physical
+controls with anything inside Ardour that can be controlled. At this
+time, these binding maps need to be created with a text editor, but we
+currently have presets for 
+</p>
+
 <ul>
 <li>Behringer BCF 2000
 </li>
diff --git a/_manual/22_using-control-surfaces/04_midi_learn.html b/_manual/22_using-control-surfaces/04_midi_learn.html
new file mode 100644
index 0000000..15fdb08
--- /dev/null
+++ b/_manual/22_using-control-surfaces/04_midi_learn.html
@@ -0,0 +1,39 @@
+---
+layout: default
+title: MIDI Learn
+---                        
+
+<h3>Philosophy<h3>
+<p>
+There are no "best" ways to map an arbitrary MIDI controller for
+controlling Ardour. There may be very legitimate reasons for different
+users to prefer quite different mappings. So, Ardour does not come
+with any pre-defined mapping - we believe that users know what is best
+for them.
+</p>
+<p>
+On every platform that Ardour runs on, there are excellent free-of-charge tools for making connections between MIDI hardware and "virtual" MIDI ports like the ones that Ardour creates and uses. Rather than waste precious developer time replicating these connection/patch managers, we prefer to leverage their existence by having users rely on them to actually connect Ardour to other MIDI devices and software. On OS X, we recommend Pete Yandell's MIDI Patchbay. On Linux, a wide variety of tools are available including QJackctl, aconnect, Patchage, and more. So, you will not find a MIDI connection dialog in Ardour 2.X.
+</p>
+
+<h3>Basics<h3>
+
+<ol>
+  <li>    Enable Generic MIDI control: Options -> Control Surfaces -> Generic MIDI</li>
+  <li>Connect Ardour's MIDI port named "control" to whatever hardware or software you want (using a MIDI patchbay app)</li>
+  <li>Ctrl-middleclick on whatever on-screen fader, plugin parameter control, button etc. that you want to control</li>
+  <li>A small window appears that says "Operate Controller now"</li>
+  <li>Move the hardware knob or fader, or press the note/key.</li>
+  <li>The binding is complete. Moving the hardware should control the Ardour fader etc. </li>
+</ol>
+
+<h3>Avoiding work in the future<h3>
+
+<p>
+If you want the bindings you set up to be used automatically in every
+session, the simplest thing to do is to use Session -> Save
+Template. Then, when creating new sessions, select that template and
+all the bindings will be automatically set up for you. You can also
+save a specific track/bus configuration as a template, and use that
+when adding new tracks or busses. Click on the track name at the top
+of a mixer strip and select "Save as Template".
+</p>