Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Git-like mirror of JOSM's Subversion repository

branch: mirror

Revert "josm-mirror: bumped externals"

This reverts commit 5755c48.
latest commit 0a3debcd22
JOSM GitHub mirror authored
Octocat-spinner-32 .externalToolBuilders Applied #3899 - patch by jpstotz - Automated creation of REVISION fil… November 14, 2009
Octocat-spinner-32 .settings cleanup in `data` folder December 18, 2013
Octocat-spinner-32 data fix #9557 - Add `railway=switch` to presets January 10, 2014
Octocat-spinner-32 data_nodist fix #6313 - validator, UnconnectedWays: handle intersections of `t` s… December 28, 2013
Octocat-spinner-32 doc applied #3147: JOSM man page provided by Ian Darwin September 04, 2009
Octocat-spinner-32 images josm-mirror: bumped externals February 26, 2014
Octocat-spinner-32 images_nodist add icon for expert mode switch January 21, 2012
Octocat-spinner-32 macosx see #8764 - Enables the HiDPI support in Apple Java 6 June 16, 2013
Octocat-spinner-32 netbeans see #8652: fix toggling panels by Tab (did not work when GPX or image… June 24, 2013
Octocat-spinner-32 patches fix #8742 - update svgsalamander to release 0.1.18+patch (fix bug SVG… June 10, 2013
Octocat-spinner-32 src Revert "josm-mirror: bumped externals" February 26, 2014
Octocat-spinner-32 styles fix #9554 - replace `emergency=aed` by `emergency=defibrillator` January 09, 2014
Octocat-spinner-32 styles_nodist fix #9062 - fix rendering of named ways with P2 map style (patch by A… November 05, 2013
Octocat-spinner-32 test fix #9561 - Bug in getDurationString January 10, 2014
Octocat-spinner-32 tools see #9450 - JOSM build from a git mirror: remove need for perl script… December 27, 2013
Octocat-spinner-32 .classpath update build.xml / test environment: August 10, 2013
Octocat-spinner-32 .project fixed #4153: Upload dialog's "Upload to '$URL'" isn't updated when th… December 12, 2009
Octocat-spinner-32 CONTRIBUTION forgot CONTRIBUTION in previous commit. Add a new section for upcomin… December 25, 2013
Octocat-spinner-32 LICENSE update license/contribution info December 18, 2013
Octocat-spinner-32 README see #8654 - New target `distmac7` to build Mac OS X package for Oracl… September 03, 2013
Octocat-spinner-32 build.xml Merge branch 'master' into mirror January 10, 2014
Octocat-spinner-32 geticons.pl remove unused icons, make connection timouts configurable and increas… June 26, 2011
Octocat-spinner-32 gpl-2.0.txt fixed #1469. patch by xeen February 24, 2009
Octocat-spinner-32 gpl-3.0.txt cleanup license and contributions a bit July 17, 2009
Octocat-spinner-32 josm.jnlp fix #8888 - set `java.util.Arrays.useLegacyMergeSort``to true in JNLP… July 20, 2013
Octocat-spinner-32 optimize-images add shell script that compresses all PNGs February 15, 2012
Octocat-spinner-32 presets_lang.pl fix #9229 - proper coding of chines links October 27, 2013
Octocat-spinner-32 start.html Make the applet code work again. October 26, 2007
README
Supplemental information for JOSM -- the Java OpenStreetMap Editor

=============================================================================
            I. Install & Launch
=============================================================================

Installation notes
------------------
To run JOSM, you need:

* The JOSM .jar file, e.g., josm-tested.jar or josm-latest.jar
* Java Runtime Environment (JRE) 1.6, or later.


How to get Java Runtime Environment
-----------------------------------
You need JRE Version 1.6 (also called Java 6), or later.

Microsoft Windows and Apple Mac OS X users should visit http://www.java.com
and download the latest Java executable for their system.

Linux users should visit http://www.oracle.com/technetwork/java/index.html
There is a Linux binary installer, which you must execute from a console, or
use the mechanism of your distribution's packaging system.


How to launch
-------------
Microsoft Windows users launch by double-clicking on the .jar file.
If this does not work, open a command shell and type
"java -jar josm-latest.jar"  in the directory that holds the file. (Please
replace josm-latest.jar with the name of your .jar file, if you aren't using
the latest version.)

Under Linux, open a shell, go to the file directory and type
"java -jar josm-latest.jar" to launch. If this does not work, try to set
your JAVA_HOME variable to the java executable location (the root location,
not the bin).

MacOS X users just click on the .jar file icon.

=============================================================================
            II. Development
=============================================================================

How to get the source code
--------------------------
Download it directly from the subversion at
https://josm.openstreetmap.de/svn/trunk. To use the command line subversion
client, type

svn co https://josm.openstreetmap.de/svn/trunk josm


Files & directories
-------------------
This is an overview of the files and directories in the JOSM code repository:
- build.xml                 ant build file (standard way to create a JOSM binary)
- CONTRIBUTION              list of major code contributors
- data/                     data files that will be included in the JOSM jar file
    - *.gsb                 NTv2 grid files for projection support
    - *.lang                translation data
    - *.xsd                 xml schema files for validation of configuration files
    - epsg                  list of projection definitions
    - help-browser.css      CSS file for the help sites (HTML content is downloaded from the website
                            on demand, but displayed inside the programm in a Java web browser component.)
    - ignoretags.cfg, tagchecker.cfg
                            data files used by the JOSM validator feature
- data_nodist/              data files that are useful for development, but not distributed
    - exif-direction-example.jpg
                            sample image, that contains direction information in the EXIF header
                            (keys: Exif.GPSInfo.GPSImgDirectionRef, Exif.GPSInfo.GPSImgDirection)
    - filterTests.osm       used for unit testing of the filter feature
                            (see test/unit/org/openstreetmap/josm/data/osm/FilterTest.java)
    - Join_Areas_Tests.osm  some examples to test the 'join areas' feature
    - mapcss/               sample map styles and corresponding data files for regression testing
    - projection-reference-data.csv
                            reference data for projection tests
                            (see test/unit/org/openstreetmap/josm/data/projection/ProjectionRefTest.java)
    - projection-regression-test-data.csv
                            regression data for projection tests
                            (see test/unit/org/openstreetmap/josm/data/projection/ProjectionRegressionTest.java)
- geticons.pl               tool, to find all used icons and allows deleting unused icons
- gpl-2.0.txt, gpl-3.0.txt  full text of the GNU General Public License
- images/                   images distributed with the JOSM binary
    - icons                 images for the Potlatch 2 style
    - styles/standard       images for the main map style (external repository)
- images_nodist/            images, which are not for distribution, but may be useful later (e.g. high
                            resolution and vector versions)
- josm.jnlp                 Java Web Start launcher file (used on the website)
- lib/                      libraries (directory is empty at the moment)
- LICENSE                   the JOSM license terms
- macosx/                   files needed to create the MacOS package
- netbeans/                 preconfigured Netbeans project
- optimize-images           short script to decrease size of PNG images
- patches/                  patches for external libraries used in JOSM (see below)
- README                    this file
- src/                      the source code of the program
- start.html                HTML page to run the applet version of JOSM
- styles/                   map styles included in JOSM
- sytles_nodist/            files needed for map style maintenance
    - potlatch2/README      infos on how to update the Potlatch 2 style from upstream sources
- test/                     automated software tests
    - data/                 resources used for some tests
    - functional/           functional tests (source code)
    - lib/                  libraries needed for (some of) the tests
    - performance/          performance tests (source code)
    - unit/                 unit tests (source code)
- tools/                    libraries and tools that help in the development process
    - animal-sniffer-ant-tasks-1.8.jar
                            TODO: what is this?
    - appbundler-1.0ea.jar  used to build Mac OS X package for Oracle Java 7
    - findbugs/             libs and config files for findbugs (automatically detects common bugs and potential
                            problems in source code); can be launched as an ant target in build.xml
    - jacocoant.jar         used to include coverage data into JUnit test reports 
    - javacc.jar            used in the build process to generate some .java files from a javacc source file
                            (src/org/openstreetmap/josm/gui/mappaint/mapcss/MapCSSParser.jj)
    - proguard.jar          optimize final binary jar - see build.xml (not used in production so far)

The 'patches' directory
-----------------------
Some 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

 * inspect the changes
 * update to a newer version of the library but keep the modifications

You can use 'quilt' to manage the patches. E.g. the following command applies all of them:

 $ quilt push -a

Of course, it is also possible to apply the patch files manually one by one.

Third party libraries
---------------------
There are a couple of third party libraries which are directly included in the source code tree, in particular:

* jmapviewer: Java component to browse a TMS map
    src/org/openstreetmap/gui (svn external)
    -> http://svn.openstreetmap.org/applications/viewer/jmapviewer/
* Apache Ant's bzip2: Support for bzip2 compression when opening files
    src/org/apache/tools/bzip2 (svn external)
    -> http://svn.apache.org/repos/asf/ant/core/trunk/src/main/org/apache/tools/bzip2
* Apache commons codec: Better Base64 support
    src/org/apache/commons/codec (svn external)
    -> http://svn.apache.org/repos/asf/commons/proper/codec/trunk/src/main/java/org/apache/commons/codec
* SVG Salamander: Support for SVG image format
    src/com/kitfox/svg
    -> http://svgsalamander.java.net/
* Metadata Extractor: Read EXIF Metadata of photos
    src/com/drew
    -> http://www.drewnoakes.com/code/exif/
* Signpost: OAuth library
    src/oauth, src/com/google
    -> http://code.google.com/p/oauth-signpost/
* GNU getopt Java port: Command line argument processing library
    src/gnu/getopt
    -> http://www.urbanophile.com/~arenn/hacking/download.html
* MultiSplitPane: Small lib for GUI layout management
    src/org/openstreetmap/josm/gui/MultiSplitLayout.java, MultiSplitPane.java
    -> http://today.java.net/pub/a/today/2006/03/23/multi-split-pane.html
* swinghelper: Class CheckThreadViolationRepaintManager to find classpath violations
    src/org/jdesktop/swinghelper/debug/CheckThreadViolationRepaintManager.java
    -> http://java.net/projects/swinghelper


Something went wrong with that request. Please try again.