Changes between Version 45 and Version 47 of Help/CommandLineOptions
- Timestamp:
- (multiple changes)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Help/CommandLineOptions
v45 v47 5 5 6 6 Four types of command line options affect JOSM: 7 * The [#Programarguments Program arguments⤓] directly control JOSM. They are called ''args'' by Java. 7 * The [#Programarguments Program arguments⤓] directly control JOSM. They are called ''args'' by Java. 8 8 * The [#Javaoptions Java options⤓] affect its environment (JVM) and are sometimes named ''VM arguments''. 9 9 * The [#run-options Run-options⤓] are involved in WebStart. Some are for diagnosis and import. … … 19 19 }}} 20 20 21 The [wikitr:/Help/Action/ShowStatusReport Status Report] from the Help menu lists the given Program arguments and Java options. 21 The [wikitr:/Help/Action/ShowStatusReport Status Report] from the Help menu lists the given Program arguments and Java options. 22 22 Some [#Examples examples⤓] for both of them are shown below. 23 23 … … 29 29 == Program arguments for JOSM ==#Programarguments 30 30 31 The first argument can be a **command** for JOSM to make it work autonomous. 31 The first argument can be a **command** for JOSM to make it work autonomous. 32 32 The commands are `render`, `project` or `runjosm` as default. 33 33 34 The remaining arguments are **options** for JOSM. 35 They can be URLs, filenames, coordinates, simple options and option=value pairs. 36 37 The options for runjosm are listed in the following. 38 At the bottom are the options for the commands 34 The remaining arguments are **options** for JOSM. 35 They can be URLs, filenames, coordinates, simple options and option=value pairs. 36 37 The options for runjosm are listed in the following. 38 At the bottom are the options for the commands [#Programargumentsrendering render⤓] and [#Programargumentsproject project⤓]. 39 39 40 40 {{{ … … 46 46 render render data and save the result to an image file 47 47 project convert coordinates from one coordinate reference system to another 48 validate validate data 48 49 49 50 For details on the render and project commands, run them with the --help option. … … 54 55 --geometry=widthxheight(+|-)x(+|-)y Standard unix geometry argument 55 56 [--download=]minlat,minlon,maxlat,maxlon Download the bounding box 56 [--download=]<URL> Download the location at the OSM-style URL57 type suitable forFile/Open)57 [--download=]<URL> Download the location at the URL (with lat=x&lon=y&zoom=z) 58 [--download=]<filename> Open a file (any file type that can be opened with File/Open) 58 59 --downloadgps=minlat,minlon,maxlat,maxlon Download the bounding box as raw GPS 59 --downloadgps=<URL> Download the location at the URL as raw GPS 60 --downloadgps=<URL> Download the location at the URL (with lat=x&lon=y&zoom=z) as raw GPS 60 61 --selection=<searchstring> Select with the given search 61 --[no-]maximize Launch in maximi sed mode62 --[no-]maximize Launch in maximized mode 62 63 --reset-preferences Reset the preferences to default 63 64 … … 70 71 --version Displays the JOSM version and exits 71 72 72 --debug Print debug info on Mapview and stdout (console) 73 --status-report Show status report with useful information that can be attached to bugs 74 75 --debug Print debugging messages to console 73 76 74 77 --skip-plugins Skip loading plugins … … 79 82 }}} 80 83 81 The `--download=` part of the download option is optional. 84 The `--download=` part of the download option is optional. 82 85 The arguments `--download`, `--downloadgps` and `--selection` are processed in this order. 83 86 The value `<url-to-xml>` can point to a local file with `file:relative/path/name.xml`. … … 91 94 {{{ 92 95 Java system properties options: 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 96 -Djosm.dir.name=JOSM Change the JOSM directory name 97 -Djosm.pref=/PATH/TO/JOSM/PREF Set the preferences directory 98 Default (Linux XDG): /home/name/.config/JOSM 99 Default (Windows): C:\Users\name\AppData\Roaming\JOSM 100 -Djosm.userdata=/PATH/TO/JOSM/USERDATA Set the user data directory 101 Default (Linux XDG): /home/name/.local/share/JOSM 102 Default (Windows): C:\Users\name\AppData\Roaming\JOSM 103 -Djosm.cache=/PATH/TO/JOSM/CACHE Set the cache directory 104 Default (Linux XDG): /home/name/.cache/JOSM 105 Default (Windows): C:\Users\name\AppData\Local\JOSM\cache 106 -Djosm.home=/PATH/TO/JOSM/HOMEDIR Set the common directory for preferences, 107 user data and ./cache/. Lower precedence. 108 Will get overridden from specific setting. 109 -Xmx...m Set maximum Java heap size in megabytes. 110 May avoid Out-of-Memory errors. 108 111 }}} 109 112 … … 137 140 java -Xmx1024m --set=message.notifier.enabled=false -jar josm.jar 138 141 # 139 # Start in an English environment and log debug info plus messages from stderr 142 # Start in an English environment and log debug info plus messages from stderr 140 143 java -Duser.language=en -jar josm.jar --debug 1>logfile.txt 2>&1 141 144 }}} … … 144 147 == Run-options for Java Web Start ==#run-options 145 148 146 The run-options are read by the `javaws` command. They control the Web Start mechanism, can encapsulate Java options and can diagnose Java. 147 {{{ 148 #!sh 149 # Control 149 The run-options are read by the `javaws` command. They control the Web Start mechanism, can encapsulate Java options and can diagnose Java. 150 {{{ 151 #!sh 152 # Control 150 153 -offline Allows to Web Start JOSM without internet access 151 154 152 155 # Encapsulate 153 -J<java option> Supplies the <java option> to the JVM 156 -J<java option> Supplies the <java option> to the JVM 154 157 -J-Xmx1024m Here: Set maximum Java heap size to 1024 megabyte 155 158 156 159 # Diagnosis 157 javaws -viewer Shows the Cache Viewer in the Java Control Panel 160 javaws -viewer Shows the Cache Viewer in the Java Control Panel 158 161 # Allows to opens the Java Control Panel from the command line. 159 162 160 163 javaws -clearcache Removes all non-installed applications from the cache 161 # Equal to 'Delete Files and Applications' from the 'Temporary File Settings' invoked 164 # Equal to 'Delete Files and Applications' from the 'Temporary File Settings' invoked 162 165 # by the 'Settings' button in the 'General' tab of the Java Control Panel. 163 166 # javaws -Xclearcache on OpenJDK 164 167 }}} 165 168 166 The `-J` run-option takes its part behind the J letter and supplies that as Java option. 167 The [wikitr:/Help/jnlpOptions jnlp-File] used by [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/javaws.html Web Start] offers a second way to [https://docs.oracle.com/javase/8/docs/technotes/guides/javaws/developersguide/syntax.html set options] for JRE and for the JOSM program directly. 169 The `-J` run-option takes its part behind the J letter and supplies that as Java option. 170 The [wikitr:/Help/jnlpOptions jnlp-File] used by [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/javaws.html Web Start] offers a second way to [https://docs.oracle.com/javase/8/docs/technotes/guides/javaws/developersguide/syntax.html set options] for JRE and for the JOSM program directly. 168 171 169 172 The `javaws` command has some control options on all systems. … … 173 176 == Other options ==#Otheroptions 174 177 175 The Launcher `josm.exe` aka [http://launch4j.sourceforge.net/docs.html#Runtime_options Launch4j] (only on [wikitr:/Download#Mswindowswrapper MS Windows]) may give some debug info. 178 The Launcher `josm.exe` aka [http://launch4j.sourceforge.net/docs.html#Runtime_options Launch4j] (only on [wikitr:/Download#Mswindowswrapper MS Windows]) may give some debug info. 176 179 {{{ 177 180 #!sh … … 182 185 == Command line for Render and Project == 183 186 184 === JOSM rendering Program marguments ===#Programargumentsrendering187 === JOSM rendering Program arguments ===#Programargumentsrendering 185 188 186 189 {{{ … … 234 237 }}} 235 238 236 === JOSM projection Program marguments ===#Programargumentsprojection239 === JOSM projection Program arguments ===#Programargumentsprojection 237 240 238 241 {{{
