Changes between Version 13 and Version 14 of Help/CommandLineOptions

Timestamp:

2016-06-20T00:23:32+02:00 (9 years ago)

Author:

dr.kludge.gm@…

Comment:

The presentation of options were cleaned up. Before it was unclear that there is a specific placement order for certain options.

Help/CommandLineOptions

@@ -4 +4 @@
 {{{
 #!sh
-java <Java-options> -jar josm.jar <options> [file]
+java <Java-Options> <JOSM-JVM-Options> -jar josm.jar <Post-Jar-Options> [file]
 }}}
-options:
+Java-Options:
+{{{
+-Xmx...m                                  Set maximum Java heap size in megabytes
+}}}
+
+For some tasks, JOSM has a large appetite for memory. On the one hand, it may be necessary to configure an  -Xmx memory size that supports more JOSM plugins and other JOSM editing features. On the other hand, slow systems or those systems with few memory resources, can be stabilized by restricting JOSM memory use.  These example Java memory settings provide examples that start with systems that have few memory resources to systems with vast amounts of memory.
+{{{
+-Xmx256m
+-Xmx512m
+-Xmx768m
+-Xmx1024m
+-Xmx1536m
+-Xmx2048m
+}}}
+
+JOSM-JVM-Options provided as Java system properties
+{{{
+-Djosm.pref=/PATH/TO/JOSM/PREF            Set the preferences directory
+-Djosm.userdata=/PATH/TO/JOSM/USERDATA    Set the user data directory
+-Djosm.cache=/PATH/TO/JOSM/CACHE          Set the cache directory
+-Djosm.home=/PATH/TO/JOSM/HOMEDIR         Relocate all 3 directories to homedir.
+-Djosm.home=/path/to/JOSM/folder/         Change the folder for all user settings. Cache directory will be in homedir/cache
+}}}
+**Note**: `-Djosm.home` has lower precedence, i.e. the specific setting overrides the general one
+
+<Post-Jar-Options> These options need to be provided after the -jar josm.jar part of the command line.
+
 {{{
 --help|-h                                 Show this help
@@ -27 +53 @@
 --offline=<osm_api|josm_website|all>      Disable access to the given resource(s), separated by comma
 }}}
-options provided as Java system properties
-{{{
--Djosm.pref=/PATH/TO/JOSM/PREF            Set the preferences directory
--Djosm.userdata=/PATH/TO/JOSM/USERDATA    Set the user data directory
--Djosm.cache=/PATH/TO/JOSM/CACHE          Set the cache directory
--Djosm.home=/PATH/TO/JOSM/HOMEDIR         Relocate all 3 directories to homedir.
--Djosm.home=/path/to/JOSM/folder/         Change the folder for all user settings. Cache directory will be in homedir/cache
-}}}
-**Note**: `-Djosm.home` has lower precedence, i.e. the specific setting overrides the general one
-
-For some tasks, JOSM needs a lot of memory. It can be necessary to add the following Java option to specify the maximum size of allocated memory in megabytes. On the other hand, on slow systems or those with less memory, you can make JOSM more stable by restricting its memory use:
-{{{
--Xmx...m                                  Set maximum Java heap size in megabytes
-}}}
 
 examples