Differences

This shows you the differences between two versions of the page.

--- development_from_svn [2012/09/23 16:35]
tedfelix New svn URL and note about the age of this info.
+++ development_from_svn [2013/10/05 06:52]
michael
@@ Line 1: / Line 1: @@
-======Installing the latest stable version of Rosegarden from svn source======
+====== Installing the latest Rosegarden source from Subversion ======
-NOTE: This page is a bit outdated.  There are other pages around the wiki that are a bit newer that you might want to check.  The page about [[dev:Eclipse|setting up Eclipse]] begins with a more current approach to getting the latest source.
+These instructions show how to install a development version of Rosegarden to use along with the version installed through your distro.  Many of these operations can be performed using graphical utilities, but it is much harder to describe point here click that across many different package managers and desktop environments, so these instructions assume you have some familiarity with the Linux command line.  You will want to go into a terminal using xterm, Konsole, GNOME Terminal or the like to enter these commands.
-These instructions should show howto install development version Rosegarden Trunk to a freshly installed distribution.
+====== .deb-based Distros (Debian, Ubuntu, Mint and Derivatives) ======
-=====1. Kubuntu 9.04 (Jaunty Jackalope)=====
+These instructions were tested with Ubuntu 12.04, but the same general process should work on all .deb-based distros, with some minor variations.
+===== Install Distro Rosegarden =====
+First, install your distro's version of Rosegarden.  It will be out of date, but this is a quick and easy way to pull in all the run-time dependencies that Rosegarden needs.
-Install first subversion.
 <code>
-sudo apt-get install subversion
+  sudo apt-get install rosegarden subversion
 </code>
-Download (takes 122 Mb of disk space) the source of the latest development version of rosegarden) using subversion.
+===== Enable Source Repositories =====
+Have a look to make sure you have source packages enabled in ''/etc/sources.list''  Lines that start with ''#'' are comments.  Lines that start with ''deb'' are for packages, and lines that start with ''deb-src'' are for source packages.  If you see lines starting with ''#deb-src'' you should remove the ''#'' to enable source repositories.  You should be left with a number of entries that resemble this short sample:
 <code>
-svn checkout svn://svn.code.sf.net/p/rosegarden/code/trunk/rosegarden rosegarden
+  deb http://us.archive.ubuntu.com/ubuntu/ precise multiverse
+  deb-src http://us.archive.ubuntu.com/ubuntu/ precise multiverse
 </code>
-or if you have a sourceforge account, checkout with (untested)
+If you changed ''sources.list'' then you'll need to do an update to pull in all the new information:
 <code>
-svn checkout svn://<username>@svn.code.sf.net/p/rosegarden/code/trunk/rosegarden rosegarden
+  sudo apt-get update
 </code>
-First, install dependencies
+===== Install Build Dependencies =====
+Having done that, the next step is to use ''apt-get buid-dep'' to install all the build dependencies.  These rarely change, and the build dependencies for any version of Rosegarden within the last couple of years should be good enough to get the current development source up and running.
 <code>
-sudo apt-get install autoconf g++ libqt4-dev ladspa-sdk liblircclient-dev libjack0.100.0-dev jackd libasound2-dev xutils-dev
+  sudo apt-get build-dep rosegarden
 </code>
-Note: while building on Karmic Koala the following dependencies were missing:
+===== Create Build Directory (Folder) =====
+Now you need to decide where you want to build Rosegarden.  Michael always creates a ''~/SVN'' directory for this purpose, but you can put it anywhere you have write and execute permissions, and if you intend to use [[dev:eclipse|Eclipse]] there may be special naming considerations.  I assume you have no better ideas but to follow my lead, so:
 <code>
-sudo apt-get install dssi-dev liblo0-dev liblrdf0-dev libfftw3-dev libsndfile1-dev libsamplerate0-dev
+  mkdir ~/SVN
 </code>
-After installing the dependencies, generate (again) the configure script, run it and compile the source
+===== Get the Source =====
+With that done you will want to change to your build directory.  I assume ~/SVN; please adjust to suit your local situation, and check out the source:
 <code>
-sh ./bootstrap.sh
+  cd ~/SVN
-./configure
-make
 </code>
-Before running Rosegarden, install couple of necessary packages
+If you have a SourceForge account and think you might want to contribute patches, check out the source using your SourceForge ID:
 <code>
-sudo apt-get install flac qjackctl sox
+  svn checkout --username=[YOUR USERID] https://svn.code.sf.net/p/rosegarden/code/trunk/rosegarden rosegarden-svn
 </code>
-Install LilyPond either with
+Otherwise, just check out a read-only copy:
 <code>
-sudo apt-get install lilypond
+  svn checkout svn://svn.code.sf.net/p/rosegarden/code/trunk/rosegarden rosegarden-svn
 </code>
-or, if you do **not** want to install TeX (extra ~150 Mb) which is not necessary, download stable (2.12.*) LilyPond installing binary. Find out what is the latest stable LilyPond version with command
+===== Bootstrap and Configure =====
+Once you've got the source to ''rosegarden-svn'' under the directory of your choice, move into it, and bootstrap the source:
 <code>
-wget http://download.linuxaudio.org/lilypond/binaries/linux-x86/ -O -
+  cd rosegarden-svn
+  sh bootstrap.sh
 </code>
-Download then the latest version and install it
+Now you need to configure the source.  Lately, I have been running 64-bit distros, and on recent 64-bit versions of Ubuntu this step is a little more complicated than it used to be.  The first thing you should try is this:
 <code>
-wget http://download.linuxaudio.org/lilypond/binaries/linux-x86/lilypond-2.12.2-1.linux-x86.sh
+  ./configure
-sudo sh ./lilypond-2.12.2-1.linux-x86.sh
 </code>
-You probably want software synthesis, install thus e.g. timidity and freepats
+If that fails with some error about Qt libraries, you will need to use:
 <code>
-sudo apt-get install timidity freepats
+  ./configure --with-qtlibdir=/usr/lib/x86_64-linux-gnu/
 </code>
-Now we are ready to run Rosegarden!
+If //that// fails, you probably need to try replacing ''x86_64-linux-gnu'' with something else.  Look in ''/usr/lib'' for clues, as every one of my Linux systems is 64-bit now.
+===== Build and Run =====
+Now that you've gotten the source bootstrapped and configured, the next step is to build and run.
-Start Rosegarden...
 <code>
-rosegarden
+  make && ./rosegarden
 </code>
-If you would like to have Rosegarden translated into your language, see [[../../Add or update translation|how to add or update translation]].
+If all went well, your computer bogged down pretty hard for 10-15 minutes, and then your shiny new development version of Rosegarden started up.  You can help us test bug fixes and new features ahead of releases, and we are happy to have the help!  (In the future, you can run with ''./rosegarden'' or you can modify an icon on your desktop to run ''~/SVN/rosegarden-svn/rosegarden'' instead of the usual ''/usr/bin/rosegarden''.)
+If something went wrong, don't hesitate to send an email to [[mailto:michael.mcintyre@rosegardenmusic.com|Michael]] and ask for help.  He will be glad to help you along, and will usually reply within three days.
+Good luck!
+===== Update =====
+You will need to keep your development source refreshed, and compile it from time to time.  If a developer fixes a bug or adds a feature, you will need to update in order to obtain the newest code:
+<code>
+  svn update
+  make && ./rosegarden
+</code>
+Occasionally an update may break things.  Let's just cross that bridge when we come to it.
+====== Other Distros ======
+Nothing here yet.  I've been using Ubuntu since 2005 or so, and I'm very satisfied with it.  Other people can write the instructions for other distros.  Sorry.
+(Note, due to high amounts of spamming, it is necessary to ask Michael for a wiki account.  He will be happy to get one set up for you in a day or two.)