X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=_manual%2F03_setting-up-your-system%2F05_setting-up-midi.html;h=69686cb069014d5e51e5d8b1f5fb3c2ee2b81edc;hb=9b7e5ba52fa3a4325daf4631b7b564595e1a710f;hp=fc5faa42dc7009cffba879add1612b07c80f891b;hpb=7088d7d2e5632f3e8b38ac8fd9e85aa9d62f9402;p=ardour-manual-diverged

diff --git a/_manual/03_setting-up-your-system/05_setting-up-midi.html b/_manual/03_setting-up-your-system/05_setting-up-midi.html
index fc5faa4..69686cb 100644
--- a/_manual/03_setting-up-your-system/05_setting-up-midi.html
+++ b/_manual/03_setting-up-your-system/05_setting-up-midi.html
@@ -2,5 +2,55 @@
 layout: default
 title: Setting Up MIDI
 ---                        
-    
+
+<h2>What Can Ardour Do With MIDI?</h2>
+<p>
+  <dfn><abbr title="Musical Instrument Digital
+  Interface">MIDI</abbr></dfn> is a way to describe musical
+  performances and to control music hardware and software.
+</p> 
+<p>Ardour can import and record MIDI data, and perform a variety of
+  editing operations on it. Furthermore, MIDI can be used to control
+  various functions of Ardour.
+</p>
+
+<h2>MIDI Handling Frameworks</h2>
+<p>
+  MIDI input and output for Ardour are handled by the same "engine"
+  that handles audio input and output. Up to release 3.5, that means
+  that all MIDI I/O takes place via JACK. JACK itself uses the 
+  native MIDI support of the operating system to receive and send
+  MIDI data. These are:
+</p>
+
+<dl>
+<dt>OS X</dt>
+<dd>  <dfn>CoreMIDI</dfn> is the standard MIDI framework on OSX systems. 
+  It provides drivers for MIDI hardware and libraries needed by MIDI
+  software clients. 
+</dd>
+<dt>Linux</dt>
+<dd>
+  <dfn><abbr title="Advanced Linux Sound API">ALSA</abbr> MIDI</dfn>
+  is the standard MIDI framework on Linux systems. It provides drivers 
+  for MIDI hardware and libraries needed by MIDI software clients.
+</dd>
+</dl>
+
+<p class="note">
+  NoteThe <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.
+</p>
+   
+<h2>JACK MIDI Configuration</h2>
+<p>
+By default, JACK will <strong>not</strong> automatically detect and use existing MIDI
+ports on your system. You must choose one of several ways
+of <dfn>bridging</dfn> between the native MIDI frameworks
+(e.g. CoreMIDI or ALSA) and JACK MIDI, as described in the sections
+below.
+</p>
+
 {% children %}