Changes between Initial Version and Version 1 of InstallNotes

Timestamp:

2006-07-18T15:31:18+02:00 (20 years ago)

Author:

imi

Comment:

--

InstallNotes

@@ +1 @@
+== Release ==
+The latest release is JOSM 1.2. Get it at: http://www.eigenheimstrasse.de/josm/josm-1.2.jar. The hotlink to the always latest release is http://www.eigenheimstrasse.de/josm/josm.jar
+
+== Nightly Builds ==
+You can always grab the latest nightly build - version from http://www.eigenheimstrasse.de/josm/josm-latest.jar. It is usually pretty stable too.
+
+== Getting the Source ==
+JOSM is available under GPL, and so of course you can get the sources and compile, modify or redistribute it by yourself. You can grab the sources via [http://subversion.tigris.org subversion]
+
+ svn co http://www.eigenheimstrasse.de/svn/josm
+
+''Hint: If you don't like those funny ''`.svn`'' directories, use ''`svn export`'' instead of `svn co`''
+
+Or you can inspect single files over the web frontend at http://www.eigenheimstrasse.de/svn/josm.
+
+== Compiling ==
+To build the source the most easy way, use eclipse and the provided `.project` and `.classpath` file. Just add a new Java Project using the JOSM source folder as existing path.
+
+You can also build it without eclipse. To do so, change into the `src/` folder and call `javac` on the file `org/openstreetmap/josm/Main` with `../lib/jdom.jar` in your classpath. If running linux, be sure to have your `JAVA_HOME` set. 
+
+As example, this could look like:
+
+ $ cd ~/src
+ $ svn co http://www.eigenheimstrasse.de/svn/josm
+ ''tons of output here''
+ $ export JAVA_HOME=/usr/local/jdk1.5.0
+ $ cd josm/src
+ $ javac -cp .:../lib/MinML2.jar:../lib/metadata-extractor-2.3.1.jar  org/openstreetmap/josm/gui/MainApplication.java
+
+== Running ==
+=== Microsoft Windows ===
+Launch it by double clicking on the jar file. If this does not help, open a command shell and type
+
+ java -jar ''josm.jar''
+
+in the directory that holds the file. Replace `''josm.jar''` with the name of the jar file you downloaded, e.G. `josm-latest.jar`
+
+=== Linux ===
+Open a shell, go to the file directory and type
+
+ java -jar ''josm.jar''
+
+to launch. Replace `''josm.jar''` with the name of the jar file you loaded, e.G. `josm-latest.jar`
+
+If this don't help, try to set you JAVA_HOME variable to the java location (the root location, not the bin. As example:
+
+ export JAVA_HOME=/usr/lib/sun-j2se5.0-jdk
+ java -jar ''josm.jar''
+
+If you are using KDE, there is a [http://www.eigenheimstrasse.de/josm/tutorials/setting_up_kde.avi tutorial] on how to setup your environment to start jar-files by clicking on them.
+
+If you are using GNOME, just right click on the JAR file, and select <u>O</u>pen with "Sun Java 5.0 Runtime", or whatever java version you have.
+
+If you are using XGL/Compiz then you may have to do the following:
+
+  export AWT_TOOLKIT=MToolkit && java -jar josm-test.jar
+
+as described here: http://kubasik.net/blog/index.php/2006/06/19/java-sun-150-and-xglcompiz-on-ubuntu/
+
+=== MacOS ===
+Just click on the jar-file.