~ubuntu-branches/ubuntu/oneiric/tuxguitar/oneiric

« back to all changes in this revision

Viewing changes to doc/README

  • Committer: Bazaar Package Importer
  • Author(s): Philippe Coval
  • Date: 2007-02-04 01:41:23 UTC
  • Revision ID: james.westby@ubuntu.com-20070204014123-9pv7okph0iaiqkvw
Tags: upstream-0.9.1
ImportĀ upstreamĀ versionĀ 0.9.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
DESCRIPTION:
 
2
TuxGuitar is a multitrack tablature editor and player writen in Java-SWT.
 
3
 
 
4
LICENSE:
 
5
TuxGuitar is released under the GNU Lesser General Public License.
 
6
 
 
7
REQUIREMENTS:
 
8
Java Runtime Environment 1.5.X installed in your system.
 
9
 
 
10
INSTALL:    
 
11
Extract TuxGuitar-*.tar.gz in your favorite location
 
12
$tar xfz TuxGuitar-*.tar.gz
 
13
$mv TuxGuitar-* /home/*/install_dir
 
14
       
 
15
RUN:
 
16
Run TuxGuitar script.
 
17
$/home/*/install_dir/TuxGuitar-*/TuxGuitar
 
18
 
 
19
PROBLEMS:
 
20
 
 
21
    * JAVA SOUND API:
 
22
 
 
23
Make sure, the package javax.sound is correctly implemented on your Java virtual machine.
 
24
TuxGuitar is written under Sun Java(TM) Development Kit (JDK) 5.0, if you have installed more than one JVM in your system, 
 
25
you can use one of these environment vars:  JAVA or  JAVA_HOME and run TuxGuitar.
 
26
 
 
27
Export JAVA:
 
28
$export JAVA=/usr/lib/jvm/java-1.5.0-sun/bin/java
 
29
$/home/user/TuxGuitar-*/TuxGuitar
 
30
 
 
31
Export JAVA_HOME:
 
32
$export JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun
 
33
$/home/user/TuxGuitar-*/TuxGuitar           
 
34
 
 
35
    * SWT:
 
36
 
 
37
If you see an error like "java.lang.UnsatisfiedLinkError", you will need to replace your swt shared library files and jar 
 
38
packages compiled for your system. TuxGuitar comes with SWT for linux-x86, linux-x86_64, mac and win32-x86. make sure download 
 
39
the correct file. if you need another version, download your SWT and replace in lib folder.             
 
40
If you don't have SWT installed in one of this locations: /lib, /usr/lib, /usr/local/lib or TuxGuitar/lib.  You will need to 
 
41
add its path to the LD_LIBRARY_PATH and CLASSPATH environment vars.
 
42
 
 
43
Export LD_LIBRARY_PATH and CLASSPATH:
 
44
$export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/your_swt_library_folder/
 
45
$export CLASSPATH=$CLASSPATH:/your_swt_library_folder/swt.jar
 
46
$/home/user/TuxGuitar-*/TuxGuitar
 
47
 
 
48
    * UNSUPPORTED CLASS VERSION:
 
49
 
 
50
java.lang.UnsupportedClassVersionError. This means that your JVM is not compatible with the JVM used to create the binaries.  
 
51
If you see a message like this, you will need to rebuild TuxGuitar from sources.