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%2F02_midi-on-linux.html;h=f775c83c3c2f9ba4b6a954c674b8b71943db7414;hb=ec7407419435f10f12672659aa7c7c71ef5efd13;hp=363931098c16acba08806e98e75827d827d6c04a;hpb=bbf5ab80b4e11aef49d98eb2da74f1ebea6ca7f8;p=ardour-manual

diff --git a/_manual/03_setting-up-your-system/05_setting-up-midi/02_midi-on-linux.html b/_manual/03_setting-up-your-system/05_setting-up-midi/02_midi-on-linux.html
index 3639310..f775c83 100644
--- a/_manual/03_setting-up-your-system/05_setting-up-midi/02_midi-on-linux.html
+++ b/_manual/03_setting-up-your-system/05_setting-up-midi/02_midi-on-linux.html
@@ -2,19 +2,35 @@
 layout: default
 title: MIDI on Linux
 ---                        
+
+The right approach for using MIDI on Linux depends on which version of
+JACK you use. The world divides into:
+
+<dl>
+<dt>Systems using JACK 1, versions 0.124 or later</dt>
+<dd>On these systems, just start JACK with 
+ the <code>-X alsa_midi</code> server argument. To support legacy control
+ applications, you can also use the -X seq argument to the ALSA
+ backend of JACK and get the exact same results.</dd>
+<dt>All others</dt>
+<dd>Use a2jmidid to act as a bridge between ALSA MIDI and JACK. Do
+  not use the -X seq or -X raw arguments - the timing and performance
+  of these options is not acceptable.
+</dd>
+</dl>
   
 <h2>a2jmidid</h2>
 <p>
   <dfn>a2jmidid</dfn> is an application that bridges between the system
   <abbr title="Musical Instrument Digital Interface">MIDI</abbr> ports and
-  <abbt title="JACK Audio Connection Kit">JACK</abbr>.
+  <abbr title="JACK Audio Connection Kit">JACK</abbr>.
 </p>
 <p>
   First you should make sure that there is no ALSA sequencer support enabled
   in JACK. To do that open QJackCtl's <kbd class="menu">Setup</kbd> window.
 </p>
 <p>
-  Set <kbd class="menu">Settings &gt MIDI Driver</kbd> to <kbd
+  Set <kbd class="menu">Settings &gt; MIDI Driver</kbd> to <kbd
   class="input">none</kbd>.
   Then uncheck the <kbd class="optoff">Misc &gt; Enable ALSA Sequencer
   support</kbd> option.<br />
@@ -26,19 +42,33 @@ title: MIDI on Linux
   First, check whether a2jmidid is already installed in your system. After
   starting your JACK server, go to the command line and type
 </p>
-<kbd class="lincmd">a2jmidid -e</kbd>
+<kbd class="cmd lin">a2jmidid -e</kbd>
 <p>
   If a2jmidid does not exist, install it with the software manager of your
   Linux distribution and try again.
 </p>
 
-<h3>Check surface control MIDI ports</h3>
+
+<h2>Check available MIDI ports</h2>
 <p>
-  After starting a2jmidid, your control surface MIDI ports should appear in
-  qjackctl under <kbd class="menu">Connections &gt; MIDI &gt; a2j</kbd>.
+  If you have correctly configured JACK for MIDI, then your MIDI ports should appear in
+  qjackctl under <kbd class="menu">Connections &gt; MIDI </kbd>.
 </p>
+
+<h3>Making it automatic</h3>
+<p>
+Once you've verified that the ports appear in JACK as expected, you
+can make this happen whenever you start JACK.
+</p>
+
+<p>If you use a newer version of JACK 1, just make sure the -X
+alsa_midi or -X seq options are enabled for whatever technique you use
+to start JACK.
+</p>
+
 <p>
-  You can now add <kbd class="input">a2jmidid -e</kbd> as an "after start-up" script in the <kbd
-  class="menu">Setup &gt; Options</kbd> tab of QJackCtl, so that it is
-  started automatically whenever you start JACK.
+For other versions of JACK,
+add <kbd class="input">a2jmidid -e &amp;</kbd> as an "after start-up" script
+in the <kbd class="menu">Setup &gt; Options</kbd> tab of QJackCtl, so
+that it is started automatically whenever you start JACK.
 </p>