Changes between Version 20 and Version 21 of InstallNotes

Timestamp:

2008-10-06T22:57:01+02:00 (17 years ago)

Author:

safado

Comment:

Added some Mac details for beginners

InstallNotes

@@ -83 +83 @@
 
 === MacOS ===
-Just click on the jar-file.
+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).
+
+This way to start JOSM should be sufficient in most cases.
+
+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:
+
+Start the "Terminal" application (e.g. by typing "Terminal" into the Spotlight search)
+
+Now you have two options
+
+a.) type in the following command and press "Enter" to start JOSM without any special java options (same result like clicking in the Finder):
+{{{
+java -jar FOLDER/josm-latest.jar
+}}}
+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:
+{{{
+java -jar Download/josm-latest.jar
+}}}
+
+b.) to use additional java options just add them the FOLDER/josm-latest.jar
+
+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:
+{{{
+java -Xmx256M -jar FOLDER/josm-latest.jar
+}}}
+
+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).