Changes between Version 23 and Version 24 of Help/CommandLineOptions


Ignore:
Timestamp:
2018-02-10T18:17:47+01:00 (7 years ago)
Author:
Hb---
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Help/CommandLineOptions

    v23 v24  
    44unfinished hb-
    55}}}
    6 Three groups of command line options can be involved in starting JOSM.
     6Starting JOSM is affected by three groups of command line options.
     7Most important are the ''Programm arguments'' and also the ''Java options''. The ''run-options'' are involved in Web Start only. 
    78
    89{{{
    910#!sh
    10 # Running a jar file
     11# Running a jar
    1112java [Java options] -jar josm-tested.jar [Programm arguments]
    1213
    13 # Launching a Web Start
    14 javaws [run-options] <URL|path/to/josm.jnlp>
     14# Web Start
     15javaws [run-options] josm.jnlp
    1516}}}
    1617
    17 Beginning on the right-hand-side of the command line these groups are:
    1818
    19 Programm arguments or ''Post jar arguments'' for JOSM::
    20  Control JOSM directly, for example `--language=ru` or `--skip-plugins` or `--help`
    21  <filename|URL>
    2219Java Virtual Machine options::
    2320 Control the handler of virtual machine, for example `--Xmx2048m`. The `--jar jarfile` part is a java option, too.
     
    2724`--offline`
    2825
    29 The option group names used here follow the documentation on [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html#CBBIJCHG Runtime Engine] and on [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/javaws.html Web Start].
    3026
    3127=== Programm arguments ===#Postjararguments
    3228
    33 These options need to be provided after the -jar josm.jar part of the command line.
     29Also called ''Post jar arguments'' here or ''args'' by Java.
     30The order of these arguments behind the jarfile in the command line is important for some of them.
     31
     32The first argument is the ''commmand'' for JOSM. The three possible commmands are `one` for normal work, `one` for image and `one` for something other. If JOSM can't recognize a command the default is assumed and the usual GUI is started.
     33
     34The following arguments can be URLs, coordinates, options with own arguments and filenames. See the output of the --help option below.
    3435
    3536{{{
     
    5455}}}
    5556
     57Make sure you load some data if you use `--selection`.
     58The --offline list may have commata between its items osm_api,josm_website.
     59
    5660=== Java options ===#JOSMJVMoptions
     61
     62These options are sometimes called ''JOSM JV options'' in this help or ''VM arguments'' in the JOSM status report.
    5763
    5864provided as Java system properties
     
    8793
    8894Parameters `--download`, `--downloadgps` and `--selection` are processed in this order.
    89 Make sure you load some data if you use `--selection`.
     95
     96
     97The option group names used here follow the documentation on [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html#CBBIJCHG Runtime Engine] and on [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/javaws.html Web Start].
     98
    9099
    91100=== See also ===