source: josm/trunk/README@ 5341

Last change on this file since 5341 was 5341, checked in by bastiK, 12 years ago

extend README

  • Property svn:mime-type set to text/plain;charset=utf-8
File size: 6.7 KB
1Supplemental information for JOSM -- the Java OpenStreetMap Editor
4 I. Install & Launch
7Installation notes
9To run JOSM, you need:
11* The JOSM .jar file, e.g., josm-tested.jar or josm-latest.jar
12* Java Runtime Environment (JRE) 1.6, or later.
15How to get Java Runtime Environment
17You need JRE Version 1.6 (also called Java6), or later.
19Microsoft Windows users should visit
21and download the latest Java6 executable for Windows systems.
23Linux users should visit
24There is a Linux binary installer, which you must execute from a console, or
25use the mechanism of your distribution's packaging system.
28How to launch
30Microsoft Windows users launch by double-clicking on the .jar file.
31If this does not work, open a command shell and type
32"java -jar josm-latest.jar" in the directory that holds the file. (Please
33replace josm-latest.jar with the name of your .jar file, if you aren't using
34the latest version.)
36Under Linux, open a shell, go to the file directory and type
37"java -jar josm-latest.jar" to launch. If this does not work, try to set
38your JAVA_HOME variable to the java executable location (the root location,
39not the bin).
41MacOS users just click on the .jar file icon.
44 II. Development
47How to get the source code
49Download it directly from the subversion at
50 To use the command line subversion
51client, type
53svn co josm
56Files & directories
58This is an overview of the files and directories in the JOSM code repository:
59- build.xml ant build file (standard way to create a JOSM binary)
60- CONTRIBUTION list of major code contributors
61- data/ data files that will be included in the JOSM jar file
62 - *.gsb NTv2 grid files for projection support
63 - *.lang translation data
64 - *.xsd xml schema files for validation of configuration files
65 - epsg list of projection definitions
66 - help-browser.css CSS file for the help sites (HTML content is downloaded from the website
67 on demand, but displayed inside the programm in a Java web browser component.)
68 - ignoretags.cfg, tagchecker.cfg
69 data files used by the JOSM validator feature
70- data_nodist/ data files that are useful for development, but not distributed
71 - exif-direction-example.jpg
72 sample image, that contains direction information in the EXIF header
73 (keys: Exif.GPSInfo.GPSImgDirectionRef, Exif.GPSInfo.GPSImgDirection)
74 - filterTests.osm used for unit testing of the filter feature
75 (see test/unit/org/openstreetmap/josm/data/osm/
76 - Join_Areas_Tests.osm some examples to test the 'join areas' feature
77 - mapcss/ sample map styles and corresponding data files for regression testing
78 - projection-reference-data.csv
79 reference data for projection tests
80 (see test/unit/org/openstreetmap/josm/data/projection/
81 - projection-regression-test-data.csv
82 regression data for projection tests
83 (see test/unit/org/openstreetmap/josm/data/projection/
84- tool, to find all used icons and allows deleting unused icons
85- gpl-2.0.txt, gpl-3.0.txt full text of the GNU General Public License
86- images/ images distributed with the JOSM binary
87 - icons images for the Potlatch 2 style
88 - styles/standard images for the main map style (external repository)
89- images_nodist/ images, which are not for distribution, but may be useful later (e.g. high
90 resolution and vector versions)
91- josm.jnlp Java Web Start launcher file (used on the website)
92- lib/ libraries (directory is empty at the moment)
93- LICENSE the JOSM license terms
94- macosx/ files needed to create the MacOS package
95- netbeans/ preconfigured Netbeans project
96- optimize-images short script to decrease size of PNG images
97- patches/ patches for external libraries used in JOSM (see below)
98- README this file
99- src/ the source code of the program
100- start.html HTML page to run the applet version of JOSM
101- styles/ map styles included in JOSM
102- sytles_nodist/ files needed for map style maintenance
103 - potlatch2/README infos on how to update the Potlatch 2 style from upstream sources
104- test/ automated software tests
105 - functional/ functional tests (source code)
106 - lib/ libraries needed for (some of) the tests
107 - unit/ unit tests (source code)
108- tools/ libraries and tools that help in the development process
109 - animal-sniffer-ant-tasks-1.7.jar
110 TODO: what is this?
111 - findbugs/ libs and config files for findbugs (automatically detects common bugs and potential
112 problems in source code); can be launched as an ant target in build.xml
113 - javacc.jar used in the build process to generate some .java files from a javacc source file
114 (src/org/openstreetmap/josm/gui/mappaint/mapcss/MapCSSParser.jj)
115 - proguard.jar optimize final binary jar - see build.xml (not used in production so far)
117The 'patches' directory
119Some libraries that JOSM depends on, are patched for various reasons. The files in the patches directory can be used to roll back these customizations. This is useful in order to
121 * inspect the changes
122 * update to a newer version of the library but keep the modifications
124You can use 'quilt' to manage the patches. E.g. the following command applies all of them:
126 $ quilt push -a
128Of course, it is also possible to apply the patch files manually one by one.
Note: See TracBrowser for help on using the repository browser.