Changes between Version 49 and Version 50 of InstallNotes


Ignore:
Timestamp:
2011-12-19T19:34:58+01:00 (14 years ago)
Author:
skyper
Comment:

updates + packages

Legend:

Unmodified
Added
Removed
Modified
  • InstallNotes

    v49 v50  
    2121
    2222=== Linux / *BSD ===
     23 **packages**::
     24 In some Distributions prepacked packages exist to install JOSM with your favourite package manage from the repositories.
     25 Although these packages might be a bit older than the .jar files on the main page, they usually fit better into the environment and install dependencies and a starter in the menu automatically.
     26
     27 **Note**: There is no problem with installing the prepacked package and still using the .jar files listed above.
     28
     29 If there exists no package or you do not want to use it you can download the JOSM .jar file from the main page (tested or latest version) or build it from source.
    2330
    2431 '''using the shell'''::
     
    4148
    4249 '''GNOME'''::
    43   Right click on the JAR file, and select __O__pen with "Sun Java 5.0 Runtime", or whatever java version you have.
     50  Right click on the JAR file, and select __O__pen with "Sun Java 6.0 Runtime", or whatever java version you have.
    4451
    4552 '''XGL/Compiz'''::
     
    5259
    5360 '''Blank window on startup'''::
    54 
    55 AWT before JDK7 [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6574362 doesn't play well] with non-reparenting window managers (i.e. xmonad, awesome, dwm, ratpoison, Ion3, ...), resulting in the main window not being displayed properly on startup.  The Awesome Wiki has [http://awesome.naquadah.org/wiki/Problems_with_Java workarounds] for this problem.  There is also an [http://xmonad.org/xmonad-docs/xmonad-contrib/XMonad-Hooks-SetWMName.html xmonad specific] way of doing the wmname thing.
     61  AWT before JDK7 [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6574362 doesn't play well] with non-reparenting window managers (i.e. xmonad, awesome, dwm, ratpoison, Ion3, ...), resulting in the main window not being displayed properly on startup.  The Awesome Wiki has [http://awesome.naquadah.org/wiki/Problems_with_Java workarounds] for this problem.  There is also an [http://xmonad.org/xmonad-docs/xmonad-contrib/XMonad-Hooks-SetWMName.html xmonad specific] way of doing the wmname thing.
    5662
    5763=== MacOS ===
    58 1.) If you have downloaded "josm-latest.jar" you can start JOSM by clicking on the josm-latest.jar file in the MacOS Finder (you might get the warning that you are about to open a file from the internet - just accept).
     64 1. If you have downloaded "josm-latest.jar" you can start JOSM by clicking on the josm-latest.jar file in the MacOS Finder (you might get the warning that you are about to open a file from the internet - just accept).
    5965
    60 This way to start JOSM should be sufficient in most cases.
     66 This way to start JOSM should be sufficient in most cases.
    6167
    62 2.) However, if you need to start it up with additional Java parameter(s) (e.g. -Xmx512M) you can also use the MacOS "Terminal" and start JOSM (Java) manually:
     68 2. However, if you need to start it up with additional Java parameter(s) (e.g. -Xmx512M) you can also use the MacOS "Terminal" and start JOSM (Java) manually:
    6369
    64 Start the "Terminal" application (e.g. by typing "Terminal" into the Spotlight search)
     70 Start the "Terminal" application (e.g. by typing "Terminal" into the Spotlight search)
    6571
    66 Now you have two options:
    67 
    68 a.) type in the following command and press "Enter" to start JOSM without any special java options (simply starts up JOSM like under point 1):
     72* Now you have two options:
     73 * type in the following command and press "Enter" to start JOSM without any special java options (simply starts up JOSM like under point 1):
    6974{{{
    7075java -jar FOLDER/josm-latest.jar
    7176}}}
    72 Whereas "FOLDER" should be replaced by the name of the folder you have josm-latest.jar downloaded to. If you have downloaded it to the standard MacOS "Download" Folder it would look like:
     77 Whereas "FOLDER" should be replaced by the name of the folder you have josm-latest.jar downloaded to. If you have downloaded it to the standard MacOS "Download" Folder it would look like:
    7378{{{
    7479java -jar Download/josm-latest.jar
    7580
    7681}}}
     82 * to use additional java options just add them right after "java"
    7783
    78 b.) to use additional java options just add them right after "java"
    79 
    80 If you for example have experienced the "Out of memory" warning (e.g. trying to load geo-tagged photos to JOSM) you would start JOSM like this:
     84  If you for example have experienced the "Out of memory" warning (e.g. trying to load geo-tagged photos to JOSM) you would start JOSM like this:
    8185{{{
    8286java -Xmx256M -jar FOLDER/josm-latest.jar
    8387}}}
    8488
    85 This would allow JOSM to use up to 256 MB of RAM (memory). The java option "-Xmx256M" set's the maximum Java heap size to 265 MB. You are free to replace -Xmx256M by any number appropriate for your system (e.g. -Xmx512M or even -Xmx1024M).
     89  This would allow JOSM to use up to 256 MB of RAM (memory). The java option "-Xmx256M" set's the maximum Java heap size to 265 MB. You are free to replace -Xmx256M by any number appropriate for your system (e.g. -Xmx512M or even -Xmx1024M).
    8690
    87 By the way. To get an overview of all Java start options you can type in:
    88 
     91  By the way. To get an overview of all Java start options you can type in:
    8992{{{
    9093java -help