Changes between Version 30 and Version 31 of InstallNotes


Ignore:
Timestamp:
2009-07-04T15:38:38+02:00 (15 years ago)
Author:
mabapla
Comment:

Moved "Getting the source" and "Compiling" to the end. Most users will never want to do this.

Legend:

Unmodified
Added
Removed
Modified
  • InstallNotes

    v30 v31  
    44== Nightly Builds ==
    55You can always grab the latest nightly build from http://josm.openstreetmap.de/download/josm-latest.jar. Many users actually use this for their daily work.
    6 
    7 == Getting the Source ==
    8 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]
    9 
    10  svn co http://josm.openstreetmap.de/svn/trunk josm
    11 
    12 Or you can inspect single files over the web frontend at http://josm.openstreetmap.de/svn.
    13 
    14 == Compiling ==
    15 === Using ant ===
    16 The easiest way to compile JOSM provided Java on your machine is properly set up is to go to the josm directory and type:
    17 
    18 {{{
    19  ant
    20 }}}
    21 
    22 That will create a `dist/josm-custom.jar` file if successful.
    23 
    24 === Using eclipse ===
    25 
    26 Use eclipse and the provided `.project` and `.classpath` file. Just add a new Java Project using the JOSM source folder as existing path.
    27 
    28 If you try to compile the JOSM sources in Eclipse and get errors like "The method marktr(String) is undefined for the type SomeType" look at [http://lists.openstreetmap.org/pipermail/josm-dev/2008-August/001585.html solution suggested at mailing list].
    29 
    30 === Using javac ===
    31 
    32 You can also build josm without ant or eclipse. To do so, change into the `src/` folder and call `javac` on the file `org/openstreetmap/josm/Main` with all libs from `../lib/*.jar` in your classpath (you have to specify all subsequent). If running linux, be sure to have your `JAVA_HOME` set.
    33 
    34 As example, this could look like:
    35 {{{
    36  $ cd ~/src
    37  $ svn co http://josm.openstreetmap.de/svn josm
    38  ''tons of output here''
    39  $ export JAVA_HOME=/usr/local/jdk1.5.0
    40  $ cd josm/src
    41  $ javac -cp .:../lib/MinML2.jar:../lib/metadata-extractor-2.3.1.jar:../lib/gettext-common-0.9.jar org/openstreetmap/josm/gui/MainApplication.java
    42 }}}
    436
    447== Running ==
     
    12083}}}
    12184
     85== Getting the Source ==
     86JOSM 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]
     87
     88 svn co http://josm.openstreetmap.de/svn/trunk josm
     89
     90Or you can inspect single files over the web frontend at http://josm.openstreetmap.de/svn.
     91
     92== Compiling ==
     93=== Using ant ===
     94The easiest way to compile JOSM provided Java on your machine is properly set up is to go to the josm directory and type:
     95
     96{{{
     97 ant
     98}}}
     99
     100That will create a `dist/josm-custom.jar` file if successful.
     101
     102=== Using eclipse ===
     103
     104Use eclipse and the provided `.project` and `.classpath` file. Just add a new Java Project using the JOSM source folder as existing path.
     105
     106If you try to compile the JOSM sources in Eclipse and get errors like "The method marktr(String) is undefined for the type SomeType" look at [http://lists.openstreetmap.org/pipermail/josm-dev/2008-August/001585.html solution suggested at mailing list].
     107
     108=== Using javac ===
     109
     110You can also build josm without ant or eclipse. To do so, change into the `src/` folder and call `javac` on the file `org/openstreetmap/josm/Main` with all libs from `../lib/*.jar` in your classpath (you have to specify all subsequent). If running linux, be sure to have your `JAVA_HOME` set.
     111
     112As example, this could look like:
     113{{{
     114 $ cd ~/src
     115 $ svn co http://josm.openstreetmap.de/svn josm
     116 ''tons of output here''
     117 $ export JAVA_HOME=/usr/local/jdk1.5.0
     118 $ cd josm/src
     119 $ javac -cp .:../lib/MinML2.jar:../lib/metadata-extractor-2.3.1.jar:../lib/gettext-common-0.9.jar org/openstreetmap/josm/gui/MainApplication.java
     120}}}