Differences

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

--- stacker:docs:linux_installation_instructions [2013/01/27 18:58]
rjlittlefield
+++ stacker:docs:linux_installation_instructions [2017/05/15 00:28]
rjlittlefield
@@ Line 4: / Line 4: @@
 <code>
   ZereneStacker            top level directory
-      ZereneStacker.bsh      launch script
+      ZereneStacker          executable launcher
+      ZereneStacker.bsh      launch script (provided for backward compatibility)
+      zerenstk.ini           launch template, expanded by the launcher based on user configuration settings
       ZereneStacker.jar      jar containing the application
       JREextensions          directory containing numerous .jar files
@@ Line 10: / Line 12: @@
                                (32-bit or 64-bit as appropriate)
 </code>
+The executable launcher, ZereneStacker, is written so that it can be accessed in any manner, including by symbolic link or being placed on the PATH.  If you want to use a JRE other than the one provided with the distribution, just edit the zerenstk.ini template as desired.
-The launch script assumes that the archive is unpacked into the user's home directory.
+The launch script ZereneStacker.bsh is written so that the package will run no matter where it is placed.  You can launch it from the desktop or a file browser by double-clicking it and confirming either "Run" or "Run in Terminal".  Alternatively, you can execute it from a Terminal window as ZereneStacker/ZereneStacker.bsh (plus whatever path prefix is required to find the ZereneStacker directory).
-If it is unpacked to a different location, then you must edit the ZereneStacker.bsh launch script
-so that the symbol appdir points to the location where you unpacked the .zip file.
-As distributed, the script says
-<code>appdir="$HOME/ZereneStacker"</code>
-If you download and unpack the archive to your Desktop, then the script should be edited to say
-<code>appdir="$HOME/Desktop/ZereneStacker"</code>
-With appdir properly set, executing the launch script should start Zerene
-Stacker, producing first a splash screen and then a full GUI as shown
-in the online documentation.
+For your convenience in using the package later, you may also want to create a "launcher" icon that will provide launch by double-click without the confirming dialog.  The procedure for doing that depends on what version of Linux and what desktop manager you're using.  Some helpful guidance is provided [[http://askubuntu.com/questions/64222/how-can-i-create-launchers-on-my-desktop|HERE]] at askubuntu.com.