Differences

This shows you the differences between two versions of the page.

--- user-manual:ch01s03 [2024/04/12 11:10] – created gaetan
+++ user-manual:ch01s03 [2024/04/29 15:18] (current) – removed gaetan
@@ Line 1: / Line 1: @@
-==== 1.3. Running GroIMP ====
-=== 1.3.1. From the Command Line ===
-The file `core.jar` in your installation directory of GroIMP's binary distribution is the entry-point for starting GroIMP. Running GroIMP from the command line is easy:
-> > **java -Xverify:none -jar path/to/core.jar**
-Of course, `path/to/core.jar` has to be replaced by the actual path to the file `core.jar`. E.g., if, on a Unix system, the installation directory is `/usr/lib/groimp`, the command would be
-> > **java -Xverify:none -jar /usr/lib/groimp/core.jar**
-or, on a Windows system with installation directory `C:\Program Files\GroIMP`,
-> > **java -Xverify:none -jar "C:\\Program Files\\GroIMP\\core.jar"**
-=== 1.3.2. From Your System's File Browser ===
-Because `core.jar` is an executable java archive, it is possible to start GroIMP just by (double-)clicking on the file in your system's file browser as you would do it with a usual executable file. This requires a suitable setup of your file browser, see the documentation of the browser and your Java installation if it does not already work.
-=== 1.3.3. From a Menu Entry of Your Desktop ===
-You can set up your desktop to show a menu entry for GroIMP. How this is done depends on your system. Usually your system provides a menu editor where you can create a new menu entry and specifiy the command to be executed when the entry is activated. Choose the command as you would do on command line.
-=== 1.3.4. Java Options ===
-The **java** command has several options which influence the runtime behaviour, see the documentation of your Java installation. These options have to be specified before the `-jar` option. E.g., for the Java runtime environment of Sun, the option `-Xmx` specifies the maximum amount of heap memory size that should be allocated. The default value of this option may be much smaller than your installed main memory size. In this case GroIMP cannot benefit from your memory until you specify the `-Xmx` option as in
-> > **java -Xmx400m -Xverify:none -jar path/to/core.jar**
-which allows a maximum heap memory allocation of 400 MB. If you encounter `OutOfMemoryError`s when running GroIMP, you have to specify this option with a larger value.