User documentation: installation guide updated due to recent product changes

plugins/org.yakindu.sct.doc.user/help/02_installation/installation.textile

@@ -21,7 +21,7 @@ h2. Plattform overview
 You can either install YAKINDU Statechart Tools as a stand-alone software package under the following operating systems.
 
 * "Installing YAKINDU Statechart Tools on Windows":#InstallingOnWindows
-* "Installing YAKINDU Statechart Tools on MacOS":#InstallingOnMacOS
+* "Installing YAKINDU Statechart Tools on Mac OS X":#InstallingOnMacOSX
 * "Installing YAKINDU Statechart Tools on Linux":#InstallingOnLinux
 
 Alternatively you can install YAKINDU Statechart Tools to an existing Eclipse instance.
@@ -40,17 +40,21 @@ Unpack the software distribution file. Use the file explorer to open the directo
 
 !images/windows7_install_010_eclipse_extract_1.png(Unpacking the downloaded file on Windows [1])!
 
-Choose a directory for YAKINDU Statechart Tools (SCT). The example below assumes you want to install the software in the _C:\Program Files\yakindu_sct_ directory. Please modify as needed to install somewhere else!
+Choose a directory for YAKINDU Statechart Tools (SCT). The example below assumes you want to install the software in the _C:\Program Files\YAKINDU_ directory.
+
+Depending on your permissions, you might not be able to create a directory and install software under _C:\Program Files_. In this case, please choose another installation directory at a location you are allowed to write to.
 
 !images/windows7_install_020_eclipse_extract_2.png(Unpacking the downloaded file on Windows [2])!
 
-After unpacking, you will find a folder _sct_ in your installation directory, i. e. _C:\Program Files\yakindu_sct\sct_ in our example, as shown in the image below:
+Click on _Extract_ to start the extraction process. With Window's built-in unpacker, this will take surprisingly much time. Alternatively, you can use a 3rd-party unpacker like "7-Zip":http://www.7-zip.org/. Saves you a lot of time!
+
+After unpacking, you will find a folder _yakindu-sct_ in your installation directory, i. e. _C:\Program Files\YAKINDU\yakindu-sct_ in our example, as shown in the image below:
 
-!images/windows7_install_030_eclipse_folder.png(The extracted "sct" folder)!
+!images/windows7_install_030_eclipse_folder.png(The extracted "yakindu-sct" folder)!
 
-The contents of the _sct_ folder looks like this:
+The contents of the _yakindu-sct_ folder looks like this:
 
-!images/windows7_install_040_eclipse_contents.png(Contents of the extracted "sct" folder)!
+!images/windows7_install_040_eclipse_contents.png(Contents of the extracted "yakindu-sct" folder)!
 
 There you are: You have installed YAKINDU Statechart Tools. Now you should start it.
 
@@ -58,7 +62,13 @@ h3. Starting YAKINDU Statechart Tools
 
 Start YAKINDU Statechart Tools by running the _SCT.exe_ executable.
 
-To do so, please double-click (or single-click, depending on your Windows settings) on the _YAKINDU_ symbol in the sample screenshot above.
+To do so, please double-click (or single-click, depending on your Windows settings) on the _YAKINDU_ symbol shown in the sample screenshot above.
+
+Depending on the Windows settings and your permissions, you might get the following security warning, indicating that you downloaded the application from a potentially unsecure source:
+
+!images/windows7_install_045_security_warning.png(Windows security warning)!
+
+Uncheck the _Always ask before opening this file_ option. Click _Run_ to continue starting the application. Subsequently starting YAKINDU Statechart Tools will not show this security warning again.
 
 While YAKINDU Statechart Tools is starting up, it is showing a splash screen:
 
@@ -86,22 +96,17 @@ You can "proceed":../03_getting_started/getting_started.html now to create your
 
 
 
-h2(#InstallingOnMacOS). Installing on MacOS
+h2(#InstallingOnMacOSX). Installing on Mac OS X
 
-This chapter describes how to install YAKINDU Statechart Tools on a Mac computer under MacOS.
+This chapter describes how to install YAKINDU Statechart Tools on a Mac computer under Mac OS X.
 
 h3. Unpacking the downloaded file
 
-When downloading the ZIP file containing the software distribution in a browser to your local disk, the _Archive Utility_ automatically unpacks it and then removes the ZIP file. Alternatively you can unpack the ZIP file manually by double-clicking it.
-
-Depending on the actual YAKINDU Statechart Tools software distribution file you downloaded, unpacking will provide you with one of the following application bundles:
+When downloading the ZIP file containing the software distribution in a browser to your local disk, the _Archive Utility_ automatically unpacks it by default. Upon success, the ZIP file is removed. Alternatively you can unpack the ZIP file manually by double-clicking it.
 
-table. 
-| *YAKINDU SCT4C* | YAKINDU Statechart Tools for C and C++ development |
-| *YAKINDU SCT4Java* | YAKINDU Statechart Tools for Java development |
-| *YAKINDU SCT4* | YAKINDU Statechart Tools for C, C++, and Java development |
+Unpacking will provide you with the _YAKINDU SCT_ application bundle.
 
-Move the unpacked application bundle to your _Applications_ folder or to some other directory as you see fit. The screenshot below shows the _YAKINDU SCT4C_ application bundle having been moved to the _Applications_ folder.
+Move the unpacked application bundle to your _Applications_ folder. Alternatively, you can also move it somewhere else as you see fit. The screenshot below shows the _YAKINDU SCT_ application bundle having been moved to _Applications_.
 
 !images/macosx_install_010_applications.png(The YAKINDU Statecharts Tools application in the "Applications" directory)!
 
@@ -109,15 +114,15 @@ There you are: You have installed YAKINDU Statechart Tools. Now you should start
 
 h3. Starting YAKINDU Statechart Tools
 
-Start YAKINDU Statechart Tools by running the executable you just copied to your _Applications_ folder, i. e. one of _YAKINDU SCT4C_, _YAKINDU SCT4Java_, or _YAKINDU SCT_.
+Start YAKINDU Statechart Tools by running the _YAKINDU SCT_ application.
 
-To do so, please double-click on the application symbol in the sample screenshot above.
+To do so, please double-click on the _YAKINDU_ symbol shown in the sample screenshot above.
 
-Upon the first start, MacOS will verify the application and show you the following warning, indicating that you downloaded the application from a potentially unsecure source:
+Upon the first start, Mac OS X will verify the application and show you the following security warning, indicating that you did not download the application from Apple's App Store, but from a potentially unsecure source instead:
 
-!images/macosx_install_020_warning_internet.png(MacOS warning)!
+!images/macosx_install_020_security_warning.png(Mac OS X warning)!
 
-Click _Open_ to continue starting the application. Subsequently starting YAKINDU Statechart Tools will not show this warning again.
+Click _Open_ to continue starting the application. Subsequently starting YAKINDU Statechart Tools will not show that security warning again.
 
 While YAKINDU Statechart Tools is starting up, it is showing a splash screen:
 
@@ -158,18 +163,18 @@ Go to the installation directory:
 bc(prettyprint). 
 cd /my/software/
 
-Unpack the software distribution file. If the downloaded file is located in _/download/yakindu-sct-luna-R-linux-gtk-x86_64.tar.gz_, use the following command to unpack in the installation directory:
+Unpack the software distribution file. If the downloaded file is located in _/download/sct-linux.gtk.x86_64.zip_, use the following command to unpack in the installation directory:
 
 bc(prettyprint). 
-gzip -dc /download/yakindu-sct-luna-R-linux-gtk-x86_64.tar.gz | tar xvfp -
+unzip /download/sct-linux.gtk.x86_64.zip
 
-This will create a folder _sct_ in your installation directory, i. e. _/my/software/sct_ in our example, as shown in the image below:
+This will create a folder _yakindu-sct_ in your installation directory, i. e. _/my/software/yakindu-sct_ in our example, as shown in the image below:
 
-!images/linux_install_010_eclipse_folder.png(The extracted "sct" folder)!
+!images/linux_install_010_eclipse_folder.png(The extracted "yakindu-sct" folder)!
 
-The contents of the _sct_ folder looks like this:
+The contents of the _yakindu-sct_ folder looks like this:
 
-!images/linux_install_020_eclipse_contents.png(Contents of the extracted "sct" folder)!
+!images/linux_install_020_eclipse_contents.png(Contents of the extracted "yakindu-sct" folder)!
 
 There you are: You have installed YAKINDU Statechart Tools. Now you should start it.
 
@@ -181,12 +186,12 @@ Start YAKINDU Statechart Tools by running the _SCT_ executable.
 To do so, please enter the command
 
 bc(prettyprint). 
-sct/SCT
+yakindu-sct/SCT
 
 in your installation directory. Or issue the command
 
 bc(prettyprint). 
-/my/software/sct/SCT
+/my/software/yakindu-sct/SCT
 
 if your command shell is in any other working directory.