include/configuring-midi.html

@@ -26,16 +26,25 @@
   <td><dfn><abbr title="Advanced Linux Sound API">ALSA</abbr> MIDI</dfn> is the
   standard MIDI framework on Linux systems.</td></tr>
   <tr><th>Windows</th>
-  <td><dfn><abbr title="Microsoft Multimedia Environment">MME</abbr></dfn> is the standard
-  MIDI framework on Windows systems.</td></tr>
+  <td>There is no single standard MIDI framework on Windows, but Ardour
+  can work with ASIO and others.</td></tr>
 </table>
 
 <p class="note">
-  <dfn><abbr title="JACK Audio Connection Kit">JACK</abbr></dfn> is an
-  alternate audio system which Ardour can utilize for both audio and
-  MIDI.  JACK is used to route audio between independent applications,
-  and is now considered an advanced use case which is not recommended
-  for most users.  Users with a need to use JACK for audio routing
-  should consult the latest documentation at
-  the <a href="https://jackaudio.org/">JACK website</a>.
+  On Linux systems, <dfn>QJackCtl</dfn> control software displays ALSA MIDI
+  ports under its "ALSA" tab (it does not currently display CoreMIDI ports).
+  By contrast, JACK MIDI ports show up under the <kbd class="menu">MIDI</kbd>
+  tab in QJackCtl. However, when Ardour is using jackd for audio in and out
+  the alsa MIDI ports are not accessable. When Ardour is using ALSA for audio
+  in and out then only alsa MIDI ports are accessable.
 </p>
+
+<h2>JACK MIDI Configuration</h2>
+
+<p>
+  By default, JACK will <strong>not</strong> automatically detect and use
+  existing MIDI ports. One of several ways of <dfn>bridging</dfn> between
+  the native MIDI frameworks (e.g. CoreMIDI or ALSA) and JACK MIDI must be
+  chosen, as described in the following sections.
+</p>
+

include/devices-using-mackielogic-control-protocol.html

@@ -45,7 +45,8 @@
 <p>
   Before attempting to use a Mackie Control device that communicates via
   a standard MIDI cable or a USB cable, you should ensure that
-  <a href="@@configuring-midi">your MIDI environment is setup</a>.
+  <a href="@@midi-on-linux">your Linux
+  MIDI environment is setup</a>.
   If you are using a device that uses normal MIDI (via a standard MIDI or
   USB cable), you need to connect Ardour's Mackie Control in and out ports
   to the MIDI ports leading to and coming from the control surface.

master-doc.txt

@@ -292,6 +292,22 @@ uri: setting-up-your-system/setting-up-midi
 part: chapter
 ---
 
+---
+title: MIDI on Linux
+include: midi-on-linux.html
+link: midi-on-linux
+uri: setting-up-your-system/setting-up-midi/midi-on-linux
+part: subchapter
+---
+
+---
+title: MIDI on OS X
+include: midi-on-os-x.html
+link: midi-on-os-x
+uri: setting-up-your-system/setting-up-midi/midi-on-os-x
+part: subchapter
+---
+
 ---
 title: Ardour's Interface
 uri: ardours-interface