Changes between Version 11 and Version 12 of Nl:Help/CommandLineOptions


Ignore:
Timestamp:
2018-02-17T16:24:27+01:00 (8 years ago)
Author:
DiGro
Comment:

adjusted to revision 25

Legend:

Unmodified
Added
Removed
Modified
  • Nl:Help/CommandLineOptions

    v11 v12  
    1 [[TranslatedPages(revision=24)]]
     1[[TranslatedPages(revision=25)]]
    22
    33= Opties voor de opdrachtregel =
    44{{{#!comment
    5 unfinished hb-
     5Geen inhoudsopgave
    66}}}
    77
    8 Starten van JOSM wordt beïnvloed door drie groepen van opties voor de opdrachtregel.
    9 De meest belangrijke zijn de ''Programma argumenten'' en ook de ''Java-opties''. De ''run-opties'' zijn alleen van toepassing op Web Start.
     8JOSM wordt beïnvloed door drie groepen van opties voor de opdrachtregel.
     9De [#Programarguments Programma argumenten] zijn de meest belangrijke en dan de [#Javaoptions Java-opties]. Alleen van toepassing op Web Start zijn de [#run-options run-opties]. Zie [#Examples Voorbeelden]
    1010
    1111{{{
     
    1414java [Java-opties] -jar josm-tested.jar [Programma argumenten]
    1515
    16 # Web Start
    17 javaws [run-opties] josm.jnlp
     16# Web Start starten
     17javaws [run-opties] -J[Java-optie] josm.jnlp
    1818}}}
    1919
    20 Java Virtual Machine opties::
    21  Beheer van de afhandeling van de virtuele machine, bijvoorbeeld `--Xmx2048m`. Het gedeelte `--jar jarfile` is ook een Java-optir.
    22  Beheer over de omgeving binnen de virtuele machine voor JOSM, bijvoorbeeld `-Djosm.home=/home/user/.josm_dev`
    23 WebStart run-opties::
    24  Beheer van het opstarten van de afhandeling, bijvoorbeeld `-J--Xmx2048m` om de tekenreeks 'Xmx2048m' door te geven aan de JVM
    25 `--offline`
     20=== Programma argumenten ===#Programarguments
    2621
    27 === Programma argumenten ===#Postjararguments
     22Ook wel ''Post jar-argumenten'' genoemd of ''args'' door Oracle.
    2823
    29 Hier ook wel ''Post jar-argumenten'' genoemd of ''args'' door Java.
    30 De volgorde van deze argumenten na het jar-bestand in de opdrachtregel is voor enkele ervan belangrijk.
     24Het eerste argument is de ''opdracht'' voor JOSM. De drie mogelijke opdrachten zijn `runjosm` voor normaal gebruik (standaard), `render` voor het genereren van een afbeeldingsbestand en `project` voor het converteren van coördinaten. Als JOSM een opdracht niet kan herkennen gaat het uit van de standaard en wordt de normale GUI gestart.
    3125
    32 Het eerste argument is de ''opdracht'' voor JOSM. De drie mogelijke opdrachten zijn `een` voor normaal gebruik, `een` voor afbeeldingen en `een` voor iets anders. Als JOSM de opdracht niet kan herkennen gaat het uit van de standaard en wordt de normale GUI gestart.
    33 
    34 De volgende argumenten mogen URL's, coördinaten, opties met eigen argumenten en bestandsnamen zijn. Bekijk de uitvoer van de optie --help hieronder.
     26De volgende argumenten zijn ''opties'' voor JOSM. Zij dienen te worden gescheiden door spaties. Zij mogen URL's, coördinaten, eenvoudige opties en paren optie=argument zijn. De volledige lijst met opdrachten en opties wordt hieronder weergegeven:
    3527
    3628{{{
     29gebruik:
     30  java <Java-opties> -jar josm.jar [<opdracht>] <opties>
     31opdrachten:
     32  runjosm     JOSM starten (standaard, uitgevoerd als geen opdracht is gespecificeerd)
     33  render      gegevens renderen en het resultaat opslaan als een afbeeldingsbestand
     34  project     coördinaten converteren va het ene coördinaten referentiesysteem naar een ander
     35
     36Voor details voor de opdrachten render en project, voer ze uit met de optie --help.
     37De rest van deze Helppagina documenteert de opdracht runjosm.
     38
     39opties:
    3740--help|-h                                 Deze help weergeven
    38 --geometry=widthxheight(+|-)x(+|-)y       Standaard unix geometrie argument
    39 [--download=]minlat,minlon,maxlat,maxlon  Download de bounding box
    40 [--download=]<URL>                        Download de locatie van de URL (met lat=x&lon=y&zoom=z)
    41 [--download=]<filename>                   Open een bestand (elk bestandstype dat kan worden geopend met Bestand/Openen)
    42 --downloadgps=minlat,minlon,maxlat,maxlon Download de bounding box als ruwe GPS
    43 --downloadgps=<URL>                       Download de locatie van de URL (met lat=x&lon=y&zoom=z) als ruwe GPS
     41--geometry=widthxheight(+|-)x(+|-)y       Standaard Unix geometrie argument
     42[--download=]minlat,minlon,maxlat,maxlon  Download het begrenzingsvak
     43[--download=]<URL>                        Download de locatie van de URL
     44                                          (met lat=x&lon=y&zoom=z)
     45[--download=]<filename>                   Open een bestand (hetzelfde als Menu/Bestand/Openen)
     46--downloadgps=minlat,minlon,maxlat,maxlon Download een begrenzingsvak als ruwe GPS
     47--downloadgps=<URL>                       Download de locatie van de URL
     48                                          (met lat=x&lon=y&zoom=z) als ruwe GPS
    4449--selection=<searchstring>                Selecteer met de opgegeven zoekactie
    4550
     
    4954--set=<key>=<value>                       Stel voorkeurssleutel in op waarde
    5055--language=<language>                     Stel de taal in
    51 --version                                 geeft de versie van JOSM weer en sluit
     56--version                                 Geeft de versie van JOSM weer en sluit
    5257--debug                                   Drukt berichten voor debuggen af op het scherm
    5358--skip-plugins                            Laden van plug-ins overslaan
    54 --offline=<osm_api|josm_website|all>      Toegang tot de opgegeven bron(nen) uitschakelen, gescheiden door komma
     59--offline=<osm_api|josm_website|all>      Toegang tot de opgegeven bron(nen) uitschakelen
    5560}}}
    5661
    57 Voorbeelden
     62Het gedeelte `--download=` van de optie download is optioneel.
     63Parameters `--download`, `--downloadgps` en `--selection` worden in deze volgorde verwerkt.
     64De waarde `<url-to-xml>` mag verwijzen naar een lokaal bestand met `file:relatief/pad/naam.xml`.
     65Zorg er voor dat u enige gegevens laadt als u `--selection` gebruikt.
     66De items in de optie --offline dienen te worden gescheiden door een komma.
     67
     68=== Java-opties ===#Javaoptions
     69
     70De Java-opties worden hier ook wel ''JOSM JVM-opties'' genoemd of ''VM-argumenten'' in het [wiki:/Nl:Help/Action/ShowStatusReport Statusrapport]. In dat rapport kunt u ze zien en ook de Programma-argumenten. Zij beheren de Java virtuele machine [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html (JVM)] en kunnen [https://docs.oracle.com/javase/tutorial/essential/environment/sysprop.html eigenschappen] daarin instellen. JOSM leest enkele daarvan, bijvoorbeeld `josm.home` en `user.language`.
     71
     72Java-opties:
     73          -Djosm.dir.name=JOSM                       De naam van de map voor JOSM wijzigen
     74          -Djosm.pref=/PAD/NAAR/JOSM/PREF            Stel de map voor voorkeuren in
     75                                                     Standaard: C:\Users\naam\AppData\Roaming\JOSM
     76          -Djosm.userdata=/PAD/NAAR/JOSM/USERDATA    Stel de map voor gebruikersgegevens in
     77                                                     Standaard: /home/naam/.local/share/JOSM
     78          -Djosm.cache=/PAD/NAAR/JOSM/CACHE          Stel de map voor de cache in
     79                                                     Standaard: <...>
     80          -Djosm.home=/PATH/NAAR/JOSM/HOMEDIR        Stel de algemene map in voor voorkeuren,
     81                                                     gebruikersgegevens en ./cache/. Lagere prioriteit.
     82                                                     Zal worden overschreven door specifieke instelling.
     83          -Xmx...m                                   Maximale Java heapgrootte instellen in megabytes.
     84                                                     Kan fouten voor Out-of-Memory vermijden.
     85}}}
     86
     87De optie `-Xmx...m` kan nuttig zijn als fouten [wiki:/Nl:Download#Outofmemory Out of Memory] optreden.
     88Indien u een algemene map instelt met `Djosm.home` dan zal JOSM de submappen ''./autosave'', ''./cache'' en ''./validator'' maken.
     89Indien een waarde spaties bevat, omsluit die dan met aanhalingstekens, zoals in `"josm dev"`.
     90
     91=== run-opties ===
     92De run-opties volgen op de opdracht `javaws`. Zij beheren het mechanisme Web Start en de omgeving voor de JVM.
     93
     94  -offline                  Stelt Web Start in staat JOSM te starten zonder toegang tot internet
     95  -J<java option>           verschaft de <Java-optie> aan de JVM
     96  -J-Xmx1024m               Hier: Stel de maximale heapgrootte voor Java in op 1024 megabyte
     97
     98De run-optie `-J` neemt het gedeelte na de letter J en geeft dat als Java-optie.
     99Het [wiki:/Nl:Help/jnlpOptions jnlp-bestand] dat wordt gebruikt door [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/javaws.html Web Start] biedt een tweede manier om [https://docs.oracle.com/javase/8/docs/technotes/guides/javaws/developersguide/syntax.html direct opties in te stellen] voor JRE en voor het programma JOSM.
     100
     101
     102== Voorbeelden ==
    58103{{{
    59104#!sh
    60 java -jar josm.jar track1.gpx track2.gpx london.osm
    61 java -jar josm.jar https://www.openstreetmap.org/#map=13/43.2/11.1
    62 java -jar josm.jar london.osm --selection=http://www.ostertag.name/osm/OSM_errors_node-duplicate.xml
    63 java -jar josm.jar 43.2,11.1,43.4,11.4
    64 java -jar josm.jar --set=expert=true
    65 java -Djosm.pref=$XDG_CONFIG_HOME -Djosm.userdata=$XDG_DATA_HOME -Djosm.cache=$XDG_CACHE_HOME -jar josm.jar
    66 java -Djosm.home=/home/user/.josm_dev -jar josm.jar
    67 java -Xmx1024m -jar josm.jar
     105# Laadt drie bestanden
     106  java -jar josm.jar track1.gpx BigBen.jpg "london data.osm"
     107# Download vanaf OSM overeenkomstig een URL met zoom en coördinaten
     108  java -jar josm.jar https://www.openstreetmap.org/#map=19/51.51/-0.135
     109# Download een begrenzingsvak en selecteer elk element dat overeenkomt met een tekenreeks
     110  java -jar josm.jar 51.505,-0.14,51.515,-0.13 --selection="Piccadilly Circus"
     111#
     112# Stel een map in voor JOSM overeenkomstig een eigenschap van het besturingssysteem
     113  java -Djosm.pref=$XDG_CONFIG_HOME jar josm.jar
     114# Aanhalingstekens voor waarden met een spatie erin
     115  java -Djosm.dir.name="josm dev" -jar josm.jar
     116# Stel de algemene map in in een sub-submap onder de actieve command prompt
     117  java -Djosm.home=biketour2017/london -jar josm.jar
     118# Meer geheugen in een Franstalige omgeving
     119  java -Xmx1024m -Duser.language=fr -jar josm.jar
     120#
     121# Alles in het Engels loggen
     122  java -verbose  -jar josm-latest.jar --language=en --debug >WhatsUp.txt
    68123}}}
    69124
    70 Parameters `--download`, `--downloadgps` en `--selection` worden in deze volgorde verwerkt.
    71 Zorg er voor dat u enige gegevens laadt als u `--selection` gebruikt.
    72 De lijst --offline kan opmerkingen bevatten tussen de items osm_api,josm_website.
    73 
    74 === Java-opties ===#JOSMJVMoptions
    75 
    76 Deze opties worden soms ''JOSM JV-opties'' in deze help genoemd of ''VM-argumenten'' in het statusrapport van JOSM.
    77 
    78 die worden verschaft als systeemeigenschappen van Java
    79 {{{
    80 -Djosm.pref=/PAD/NAAR/JOSM/PREF            Stel de map voor voorkeuren in
    81 -Djosm.userdata=/PAD/NAAR/JOSM/USERDATA    Stel de map voor gebruikersgegevens in
    82 -Djosm.cache=/PAD/NAAR/JOSM/CACHE          Stel de map voor de cache in
    83 -Djosm.home=/PAD/NAAR/JOSM/HOMEDIR         Verplaats alle 3 mappen naar de homedir.
    84 }}}
    85 `-Djosm.home` heeft een lagere prioriteit, d.i. de specifieke instelling gaat vóór de algemene
    86 
    87 Voor sommige taken heeft JOSM een grotere honger naar geheugen. Aan de andere kant zou het nodig kunnen zijn een -Xmx geheugengrootte te configureren die meer plug-ins voor JOSM ondersteunt en andere bewerkingsmogelijkheden voor JOSM. Aan de andere kant kunnen trage systemen of systemen met weinig bronnen voor geheugen, worden gestabiliseerd door het geheugengebruik van JOSM te beperken. Deze voorbeelden voor het instellen van Java geheugeninstellingen geven voorbeelden die systemen starten die weinig geheugenbronnen hebben naar systemen met een vaste hoeveelheid geheugen.
    88 {{{
    89 -Xmx...m                                  Maximale Java heapgrootte instellen in megabytes
    90 -Xmx256m
    91 -Xmx1024m
    92 -Xmx2048m
    93 }}}
    94 
    95 De hier gebruikte namen voor optiegroepen volgt de documentatie op [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html#CBBIJCHG Runtime Engine] en op [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/javaws.html Web Start].
    96 
    97125=== Zie ook ===
     126* [wiki:Nl:Help/Download#Troubleshooting Probleemoplossing Java]
     127* [wiki:Nl:Help/InstallNotes Opmerkingen voor installeren]
    98128* [wiki:Nl:Help/Preferences Voorkeuren] - overzichtspagina over alle "voorkeuren"
    99 * [[jnlpOptions]]