X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=_manual%2F03_setting-up-your-system%2F08_platform-specifics%2F01_ubuntu-linux.html;h=bdb2e7bba24d0a8e0bed382a2dedf7d3d9901c65;hb=47ff7920356042a51b6b14a869f823ca254670a9;hp=4fc7531351c521653c35153fa036f75a83c4f0d1;hpb=0a6bd6c66146107d148dad8e13471ddd63c82227;p=ardour-manual-diverged

diff --git a/_manual/03_setting-up-your-system/08_platform-specifics/01_ubuntu-linux.html b/_manual/03_setting-up-your-system/08_platform-specifics/01_ubuntu-linux.html
index 4fc7531..bdb2e7b 100644
--- a/_manual/03_setting-up-your-system/08_platform-specifics/01_ubuntu-linux.html
+++ b/_manual/03_setting-up-your-system/08_platform-specifics/01_ubuntu-linux.html
@@ -6,7 +6,7 @@ title: Ubuntu Linux
 <p>
   Ubuntu Linux is the most popular variety of Linux in use on desktop
   and laptop systems. It has the backing of a for-profit corporation
-  (Canonical Inc.) behind it, a defined philosophy and a huge and
+  (Canonical Inc.), a defined philosophy and a huge and
   worldwide user base. As a result, it is a common platform for people
   who want to use Ardour and other tools for music creation and
   pro-audio work. 
@@ -24,6 +24,19 @@ title: Ubuntu Linux
   </ul>
 </p>
 
+<h2>High Level Recommendations for Ubuntu Users</h2>
+
+<p>
+  Currently, installing pro audio applications on vanilla Ubuntu requires 
+  some configuration, in order for the user to gain realtime privilege 
+  (read below). 
+  Ubuntu Studio, which is an official flavor of Ubuntu, and thus shares 
+  the repositories with Ubuntu, has this already configured.
+  Another distribution, KXStudio, is largely based on Ubuntu, and also has 
+  these settings preconfigured - also containing many customized and often 
+  more up to date packages.
+<p>
+
 <h2>Problems with Ardour Packages</h2>
 
 <dl>
@@ -34,29 +47,30 @@ title: Ubuntu Linux
   released by Ubuntu has been correctly built or not. Ubuntu has a
   history of making packaging errors that lead to crashes, missing
   functionality and odd behaviour that is not present in the
-  ready-to-run version of the program that you can get from ardour.org
-  (or in the packages released by other distributions)
+  ready-to-run version of the program that you can get from <a
+  href="http://ardour.org/download">ardour.org</a> (or in the packages
+  released by other distributions)
 </p>
 <dt>Symptoms</dt>
 <dd>
 <p>
-  If you plan to use Ardour on Ubuntu, you are <strong>strongly
-  recommended</strong> to download the ready-to-run version from
-  ardour.org. Ardour's lead developer (and many of the most active
-  members of our user community) will not provide support for, and
-  will not investigate bugs reported for, Ubuntu's own packages of
-  Ardour.
+  Ardour starts up and basically runs, but you encounter subtle
+  problems (for example, with plugin GUIs or with export, or with the
+  use of certain specific plugins), or are missing functionality, or
+  run into crashes.
 </p>
 </dd>
 <dt>How to Fix</dt>
 <dd>
 <p>
-  If have already installed the Ubuntu package of Ardour and find that
-  although the program starts up and basically runs, but you are
-  running into more subtle problems (for example, with plugin GUIs or
-  with export, or with the use of certain specific plugins), then you
-  are <strong>strongly recommended</strong> to download the
-  ready-to-run version from ardour.org. 
+  Download the ready-to-run version
+  from <a href="http://ardour.org/download">ardour.org</a>. Ardour's
+  lead developer (and many of the most active members of our user
+  community) will not provide support for, and will not investigate
+  bugs reported for, Ubuntu's own packages of Ardour. The ardour.org
+  packages install along side your distribution versions, and do not
+  interfere or interact in anyway other than sharing your own personal
+  Ardour settings and configuration choices.
 </p>
 </dd>
 </dl>
@@ -98,22 +112,17 @@ title: Ubuntu Linux
 <dt>What is the problem?</dt>
 <dd>
 <p>
-  This relatively simple system ought to be the basis for excellent
-  cooperation between PulseAudio and JACK. Unfortunately, it relies on
-  everything being correctly configured for it to work, and Ubuntu
-  have repeatedly failed to get this configuration correct.
-</p>
-<p>
-  The specific issues known at this time (spring 2013) are:
+  The specific issues known at this time for all flavors of Ubuntu
+  12.04 and 12.10 are:
   <ul>
     <li>a bug in PulseAudio that causes it not to give up the
-      soundcard when JACK asks</li>
-    <li>bad package dependency information that causes a critical
-      package to be missing even when JACK and PulseAudio are
-      installed</li>
-    <li>a bug that causes JACK to freeze up when told to stop, 
-      causing issues with restarting</li>
+      soundcard when JACK asks (<a href="https://bugs.launchpad.net/ubuntu/+source/pulseaudio/+bug/1163638">LP: #1163638</a>
+      (fixed in Ubuntu 13.04).</li>
+    <li>a bug that causes jackdbus v.1.9.8 (jackd does not suffer from this) 
+      to freeze up when told to stop, causing issues with restarting (<a href="https://bugs.launchpad.net/ubuntu/precise/+source/jackd2/+bug/956438">LP: #956438</a></li>
+      (fixed in Ubuntu 13.04)
   </ul>
+</p>
 </dd>
 <dt>Symptoms</dt>
 <dd>
@@ -121,12 +130,14 @@ title: Ubuntu Linux
   <ul>
     <li>Cannot start JACK (though see the next section for other
       causes of this)</li>
-    <li>JACK starts but there is no sound coming from Ardour or other
-    applications that use JACK.</li>
   </ul>
 </p>
 </dd>
 <dt>How to fix</dt>
+<p>
+  These bugs do not affect the upcoming 13.04 release, and earlier 
+  releases (12.04 and 12.10) are in the process of being fixed.
+</p>
 <dd>
 </dd>
 </dl>
@@ -142,8 +153,8 @@ title: Ubuntu Linux
       locking". This means that you, the user who starts JACK, must be
       allowed access to these facilities. By default, Ubuntu does create a
       user group that has this permission but ... it does not put new
-      users into this group by default. Consequently, you will not have
-      permission to run JACK in the way you should.
+      users into this group by default. Read more about why <a href="https://wiki.ubuntu.com/Audio/TheAudioGroup">here</a>.
+      Consequently, you will not have permission to run JACK in the way you should.
     </p>
   </dd>
   <dt>Symptoms</dt>
@@ -157,9 +168,19 @@ title: Ubuntu Linux
   <dt>How to fix</dt>
   <dd>
     <p>
+      Make sure the file /etc/security/limits.d/audio.conf exists. If it is
+      named /etc/security/limits.d/audio.conf.disabled, rename it to the former.
       Run the command <code>sudo usermod -a -G
         audio <em>YOUR-LOGIN-NAME</em></code>. Then logout and login again.
+      On Ubuntu Studio the user is a member of audio group by default, but not
+      on other official flavors.
     </p>
   </dd>
 </dl>
-
+  <h2>Reporting Issues</h2>
+<p>Given the difficulties in supporting Ubuntu and the limited time/resources of the Ardour team, the <code>Ubuntu Studio Project</code> has requested that issues and bug reports related to Ubuntu, Ubuntu Studio and other derivitives be directed to them.<p>
+<h4>Contact Information for Ubuntu Studio</h4>
+<p><a href="http://ubuntustudio.org" target="_blank">The Ubuntu Studio Homepage</a></p>
+<p><a href="http://ubuntuforums.org/forumdisplay.php?f=335" target="_blank">The Ubuntu Studio Forums.</a></p>
+<p><a href="https://help.ubuntu.com/community/UbuntuStudio/MailLists" target="_blank">Information on the Ubuntu Studio Mailing Lists.</a></p>
+<p><a href="https://help.ubuntu.com/community/UbuntuStudio/IRC" target-"_blank">Information on the Ubuntu Studio IRC channel.</a> #ubuntustudio on irc.freenode.net</p>