Changes between Version 58 and Version 59 of InstallNotes


Ignore:
Timestamp:
2012-10-12T14:51:05+02:00 (13 years ago)
Author:
skyper
Comment:

use internal links + source highlighting

Legend:

Unmodified
Added
Removed
Modified

  • InstallNotes

    v58 v59  
    33
    44== Semi-Stable Version ==
    5 The latest semi-stable version is always here: [http://josm.openstreetmap.de/josm-tested.jar] - we don't call it a "release" because while it is more robust than the nightly build, it doesn't usually run through as many checks as a release would.
     5The latest semi-stable version is always here: [/josm-tested.jar] - we don't call it a "release" because while it is more robust than the nightly build, it doesn't usually run through as many checks as a release would.
    66
    77== Nightly Builds ==
    8 You can always grab the latest nightly build from [http://josm.openstreetmap.de/josm-latest.jar]. Many users actually use this for their daily work.
     8You can always grab the latest nightly build from
     9[/josm-latest.jar]. Many users actually use this for their daily work.
    910
    1011== Running ==
    … …  
    3132 **Note**: There is no problem with installing the prepacked package and still using the .jar files listed above.
    3233
    33  If there exists no package or you do not want to use it you can download the JOSM .jar file from the main page (tested or latest version) or build it from source.
     34 If there exists no package or you do not want to use it you can download the JOSM .jar file from the [WikiStart main page] (tested or latest version) or build it from source.
    3435
    3536 '''using the shell'''::
    … …  
    3940java -jar josm-latest.jar
    4041}}}
    41   to launch. Replace `''josm-latest.jar''` with the name of the jar file you loaded, e.G. `josm.jar` for releases.
     42  to launch. Replace `josm-latest.jar` with the name of the jar file you loaded, e.G. `josm.jar` for releases.
    4243
    4344  If this doesn't help, try to set your JAVA_HOME variable to the java location (the root location, not the bin. As example:
    … …  
    6667
    6768=== MacOS ===
    68 1. If you have downloaded "josm-latest.jar" you can start JOSM by clicking on the josm-latest.jar file in the MacOS Finder (you might get the warning that you are about to open a file from the internet - just accept).
     691. If you have downloaded `josm-latest.jar` you can start JOSM by clicking on the josm-latest.jar file in the MacOS Finder (you might get the warning that you are about to open a file from the internet - just accept).
    6970
    7071 This way to start JOSM should be sufficient in most cases.
    … …  
    7980 * type in the following command and press "Enter" to start JOSM without any special java options (simply starts up JOSM like under point 1):
    8081{{{
     82#!sh
    8183java -jar FOLDER/josm-latest.jar
    8284}}}
    8385 Whereas "FOLDER" should be replaced by the name of the folder you have josm-latest.jar downloaded to. If you have downloaded it to the standard MacOS "Downloads" Folder it would look like:
    8486{{{
     87#!sh
    8588java -jar Downloads/josm-latest.jar
    86 
    8789}}}
    8890 * to use additional java options just add them right after "java"
    … …  
    9092  If you for example have experienced the "Out of memory" warning (e.g. trying to load geo-tagged photos to JOSM) you would start JOSM like this:
    9193{{{
     94#!sh
    9295java -Xmx256M -jar FOLDER/josm-latest.jar
    9396}}}
    … …  
    97100  By the way. To get an overview of all Java start options you can type in:
    98101{{{
     102#!sh
    99103java -help
    100104}}}
    … …  
    102106== Getting the Source ==
    103107JOSM 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]
    104 
    105  svn co http://josm.openstreetmap.de/svn/trunk josm
    106 
    107 Or you can inspect single files over the web frontend at http://josm.openstreetmap.de/svn.
     108{{{
     109#!sh
     110svn co http://josm.openstreetmap.de/svn/trunk josm
     111}}}
     112Or you can inspect single files over the web frontend at [/svn.]
    108113
    109114== Compiling ==
    … …  
    112117
    113118{{{
    114  ant
     119#!sh
     120ant
    115121}}}
    116122
    … …  
    132138
    133139 * Check out the sources
    134 
    135140{{{
     141#!sh
    136142$ svn co http://josm.openstreetmap.de/svn/trunk josm
    137143        ''tons of output here''
    … …  
    141147 * Compile and run
    142148{{{
     149#!sh
    143150$ javac -cp .:src -d build src/org/openstreetmap/josm/gui/MainApplication.java
    144151$ java -cp .:build org.openstreetmap.josm.gui.MainApplication
    … …  
    153160You can run tests from the command line, as well. Include all libraries in the class path like this:
    154161{{{
     162#!sh
    155163export TESTCP=".:test/unit:test/functional:dist/josm-custom.jar:test/lib/fest/fest-assert-1.0.jar:test/lib/fest/MRJToolkitStubs-1.0.jar:test/lib/fest/jcip-annotations-1.0.jar:test/lib/fest/fest-swing-1.1.jar:test/lib/fest/fest-reflect-1.1.jar:test/lib/fest/fest-util-1.0.jar:test/lib/fest/debug-1.0.jar:test/lib/junit/junit-4.6.jar:test/lib/jfcunit.jar:test/lib/unitils-core/ognl-2.6.9.jar:test/lib/unitils-core/commons-lang-2.3.jar:test/lib/unitils-core/unitils-core-3.1.jar:test/lib/unitils-core/junit-4.4.jar:test/lib/unitils-core/commons-logging-1.1.jar:test/lib/unitils-core/commons-collections-3.2.jar"
    156164}}}
    157165Then run for example
    158166{{{
     167#!sh
    159168javac -cp $TESTCP test/unit/org/openstreetmap/josm/data/projection/ProjectionRefTest.java
    160169java -cp $TESTCP org.junit.runner.JUnitCore org.openstreetmap.josm.data.projection.ProjectionRefTest