Merge branch 'patch/JAL-3700_JAL-3748_JAL-3763_for_2_11_1_3' into releases/Release_2_...
[jalview.git] / README
diff --git a/README b/README
index bfc65f5..8172066 100755 (executable)
--- a/README
+++ b/README
@@ -4,11 +4,13 @@ Jalview Readme
 
 The source is available as a tar file and comes complete with the GNU General Public License. 
 
-To build the application you will need a J2SDK 1.5+. 
+To build the application you will need a J2SDK 1.7+. 
 
 An Ant build file (build.xml) is provided, you will need to install Apache Ant first. 
 Run ant to view usage which will display a list of useful build targets.
 
+Jalview is primarily developed with eclipse, and a .project file is provided to simplify importing the source into your own eclipse workspace. A NetBeans nbbuild.xml file is also provided for developing Jalview with NetBeans - but this is not officially supported.
+
 You may also be able to use Borland JBuilder to build Jalview. A JBuilder project file 
 (JalviewX.jpx, JalviewApplet.jpx) for both application and applet is provided, 
 but the library dependencies are almost certainly out of date. See the build.xml 
@@ -19,11 +21,19 @@ For more help, read the file doc/building.html
 
 ##################
 
-To run application:
+To run application...
+[ NOTE: when using the -classpath option with the '*' wildcard, the argument must be quoted to avoid shell expansion of the wildcard,
+  ALSO, the wildcard MUST be as DIR/* and not DIR/*.jar etc or it will not be interpreted correctly ]
+
+on Windows use:
+  java -classpath "JALVIEW_HOME/lib/*;JALVIEW_HOME/jalview.jar" jalview.bin.Jalview
+and on MacOS or Linux:
+  java -classpath "JALVIEW_HOME/lib/*:JALVIEW_HOME/jalview.jar" jalview.bin.Jalview
+
+Replace JALVIEW_HOME with the full path to Jalview Installation Directory. If building from source:
 
-java -Djava.ext.dirs=JALVIEW_HOME/lib -cp JALVIEW_HOME/jalview.jar jalview.bin.Jalview
+  java -classpath "JALVIEW_BUILD/dist/*" jalview.bin.Jalview
 
-Replace JALVIEW_HOME with the full path to Jalview Installation Directory.
 
 ##################