~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: 2008-06-19 00:30:30 UTC
  • mto: (5.1.2 sid)
  • mto: This revision was merged to the branch mainline in revision 3.
  • Revision ID: james.westby@ubuntu.com-20080619003030-h719szrhsngou7c6
Tags: upstream-1.0
ImportĀ upstreamĀ versionĀ 1.0

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.