Changes between Version 41 and Version 42 of Help/CommandLineOptions

Timestamp:

2021-01-19T10:52:03+01:00 (4 years ago)

Author:

Hb---

Comment:

URL format (with lat=x&lon=y&zoom=z) is outdated. Logging like #20401. All example data around Big Ben

Help/CommandLineOptions

@@ -7 +7 @@
  * The [#Programarguments Program arguments⤓] directly control JOSM. They are called ''args'' by Java. 
  * The [#Javaoptions Java options⤓] affect its environment (JVM) and are sometimes named ''VM arguments''.
- * Involved in Web Start and diagnosis are the [#run-options Run-options⤓]. 
+ * The [#run-options Run-options⤓] are involved in WebStart. Some are for diagnosis and import.
  * Some [#Otheroptions Other options⤓] for helper programs.
 
@@ -13 +13 @@
 #!sh
 # Running a jar
-java [Java options] -jar josm-tested.jar [Program arguments]
+java [Java options] -jar josm.jar [Program arguments]
 
 # Launch a Web Start
@@ -19 +19 @@
 }}}
 
-The [wikitr:/Help/Action/ShowStatusReport Status Report] lists the given Program arguments and Java options in its second section. 
+The [wikitr:/Help/Action/ShowStatusReport Status Report] from the Help menu lists the given Program arguments and Java options. 
 Some [#Examples examples⤓] for both of them are shown below.
-As usual the arguments are separated by space from each other.
+
+**Note:** The term {{{josm.jar}}} is a common abbreviation for the file names ''josm-tested.jar'' and ''josm-latest.jar''.
+The name ''josm.jnlp'' also stands for ''josm-latest.jnlp''.
+As usual the command line arguments are separated by space from each other.
+
 
 == Program arguments for JOSM ==#Programarguments
@@ -50 +54 @@
         --geometry=widthxheight(+|-)x(+|-)y       Standard unix geometry argument
         [--download=]minlat,minlon,maxlat,maxlon  Download the bounding box
-        [--download=]<URL>                        Download the location at the URL (with lat=x&lon=y&zoom=z)
-        [--download=]<filename>                   Open a file (any file type that can be opened with File/Open)
+        [--download=]<URL>                        Download the location at the OSM-style URL
+        [--download=]<filename>                   Open a file (any type suitable for File/Open)
         --downloadgps=minlat,minlon,maxlat,maxlon Download the bounding box as raw GPS
-        --downloadgps=<URL>                       Download the location at the URL (with lat=x&lon=y&zoom=z) as raw GPS
+        --downloadgps=<URL>                       Download the location at the URL as raw GPS
         --selection=<searchstring>                Select with the given search
         --[no-]maximize                           Launch in maximised mode
@@ -66 +70 @@
         --version                                 Displays the JOSM version and exits
 
-        --debug                                   Print debugging messages to console
+        --debug                                   Print debug info on Mapview and stdout (console)
 
         --skip-plugins                            Skip loading plugins
@@ -106 +110 @@
 When the non-ASCII characters in the command prompt are scrambled, use `-Dfile.encoding=Cp850` to receive text from Java in another [https://docs.oracle.com/javase/8/docs/technotes/guides/intl/encoding.doc.html code page].
 Which [https://msdn.microsoft.com/de-de/library/windows/desktop/dd317756%28v=vs.85%29.aspx code page] is used shows `chcp⏎` in the terminal.
-For UTF-8 on Windows, invoke `chcp 65001` in the Windows terminal window before launching JOSM using `java -Dfile.encoding=UTF-8 -jar josm-tested.jar`
+For UTF-8 on Windows, invoke `chcp 65001` in the Windows terminal window before launching JOSM using `java -Dfile.encoding=UTF-8 -jar josm.jar`
 
 [=#Examples **Examples for JOSM runjosm options and Java options**]
@@ -112 +116 @@
 #!sh
 # Load three files
-  java -jar josm-tested.jar track1.gpx BigBen.jpg "london data.osm"
+  java -jar josm.jar track1.gpx BigBen.jpg "london data.osm"
 # Download from OSM according to an URL with zoom and coordinates
-  java -jar josm-tested.jar https://www.openstreetmap.org/#map=19/51.51/-0.135
+  java -jar josm.jar https://www.openstreetmap.org/#map=18/51.501/-0.124
 # Download a bounding box and select every element matching a string
-  java -jar josm-tested.jar 51.505,-0.14,51.515,-0.13 --selection="Piccadilly Circus"
+  java -jar josm.jar 51.500,-0.126,51.502,-0.122 --selection="Big Ben"
 #
 # Set directory for JOSM according to a property from the operating system
-  java -Djosm.pref=$XDG_CONFIG_HOME -jar josm-tested.jar
+  java -Djosm.pref=$XDG_CONFIG_HOME -jar josm.jar
 # Quotations for a value with space and show JOSMs GUI in English
-  java -Djosm.dir.name="josm dev" -jar josm-latest.jar --language=en
-# Set the common directory in a sub-subdirectroy below the active command prompt
-  java -Djosm.home=biketour2017/london -jar josm-tested.jar
-# More memory in the Canadian variant of an English spoken environment
-  java -Xmx1024m -Duser.language=en -Duser.country=CA -jar josm-latest.jar
+  java -Djosm.dir.name="josm dev" -jar josm.jar --language=en
+# Set the common directory in a sub-subdirectory below the active command prompt
+  java -Djosm.home=biketour2017/london -jar josm.jar
+# More memory and without phoning home
+  java -Xmx1024m --set=message.notifier.enabled=false  -jar josm.jar
 #
-# Log debug info and do not get disturbed by JOSM phoning home
-  java -verbose -jar josm-latest.jar --set=message.notifier.enabled=false --debug >WhatsUp.txt
+# Start in an English environment and log debug info plus messages from stderr 
+  java -Duser.language=en -jar josm.jar --debug 1>logfile.txt 2>&1
 }}}
 
 
 == Run-options for Java Web Start ==#run-options
+
 The run-options are read by the `javaws` command. They control the Web Start mechanism, can encapsulate Java options and can diagnose Java. 
 {{{
@@ -256 +261 @@
 }}}
 
-On this page 'josm.jar' is short for one of the releases josm-tested.jar or josm-latest.jar.
 
 == See also ==