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

« back to all changes in this revision

Viewing changes to 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 written 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.4.X or later 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
    * SWT:
 
22
 
 
23
If you see an error like "java.lang.UnsatisfiedLinkError", you will need to replace your swt shared library files and jar 
 
24
packages compiled for your system. TuxGuitar comes with SWT for linux-x86, linux-x86_64, mac and win32-x86. make sure download 
 
25
the correct file. if you need another version, download your SWT and replace in lib folder.             
 
26
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 
 
27
add its path to the LD_LIBRARY_PATH and CLASSPATH environment vars.
 
28
 
 
29
Export LD_LIBRARY_PATH and CLASSPATH:
 
30
$export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/your_swt_library_folder/
 
31
$export CLASSPATH=$CLASSPATH:/your_swt_library_folder/swt.jar
 
32
$/home/user/TuxGuitar-*/TuxGuitar
 
33
 
 
34
    * UNSUPPORTED CLASS VERSION:
 
35
 
 
36
java.lang.UnsupportedClassVersionError. This means that your JVM is not compatible with the JVM used to create the binaries.  
 
37
If you see a message like this, you will need to rebuild TuxGuitar from sources.
 
38
 
 
39
    * FAILDED TO LOAD PLUGINS:
 
40
 
 
41
TuxGuitar 1.0 has better JVM compatibility than older releases. But some plugins (e.g: Java Sound Api plugin) still depends 
 
42
on Sun Java(TM) Development Kit (JDK) 5.0. if you have installed more than one JVM in your system, you can use one of these 
 
43
environment vars:  JAVA or JAVA_HOME to run TuxGuitar with a specified JVM.
 
44
 
 
45
Export JAVA:
 
46
$export JAVA=/usr/lib/jvm/java-1.5.0-sun/bin/java
 
47
$/home/user/TuxGuitar-*/tuxguitar
 
48
 
 
49
Export JAVA_HOME:
 
50
$export JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun
 
51
$/home/user/TuxGuitar-*/tuxguitar