Index: /trunk/README =================================================================== --- /trunk/README (revision 5544) +++ /trunk/README (revision 5545) @@ -4,5 +4,5 @@ I. Install & Launch ============================================================================= - + Installation notes ------------------ @@ -10,16 +10,16 @@ * The JOSM .jar file, e.g., josm-tested.jar or josm-latest.jar -* Java Runtime Environment (JRE) 1.6, or later. +* 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. +You need JRE Version 1.6 (also called Java 6), or later. -Microsoft Windows users should visit http://www.java.com +Microsoft Windows users should visit http://www.java.com and download the latest Java executable for Windows systems. 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 +There is a Linux binary installer, which you must execute from a console, or use the mechanism of your distribution's packaging system. @@ -35,5 +35,5 @@ 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, +your JAVA_HOME variable to the java executable location (the root location, not the bin). @@ -46,6 +46,6 @@ 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 +Download it directly from the subversion at +https://josm.openstreetmap.de/svn/trunk. To use the command line subversion client, type @@ -63,10 +63,10 @@ - *.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 + - 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 + - exif-direction-example.jpg sample image, that contains direction information in the EXIF header (keys: Exif.GPSInfo.GPSImgDirectionRef, Exif.GPSInfo.GPSImgDirection) @@ -75,8 +75,8 @@ - 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 + - projection-reference-data.csv reference data for projection tests (see test/unit/org/openstreetmap/josm/data/projection/ProjectionRefTest.java) - - projection-regression-test-data.csv + - projection-regression-test-data.csv regression data for projection tests (see test/unit/org/openstreetmap/josm/data/projection/ProjectionRegressionTest.java) @@ -86,5 +86,5 @@ - 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 +- 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) @@ -118,8 +118,8 @@ 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 + * 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: +You can use 'quilt' to manage the patches. E.g. the following command applies all of them: $ quilt push -a @@ -127,3 +127,35 @@ 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 + +