Changes between Version 76 and Version 77 of InstallationInstructions

Timestamp:

Sep 26, 2020 12:31:45 PM (4 years ago)

Author:

magne

Comment:

--

InstallationInstructions

@@ -20 +20 @@
 * You need the full JDK (Java Development Kit), not just a JRE (Java Runtime Environment).
 * Make certain you choose a JDK 8 from summer 2017 or later due to certificate issues with some of the Eclipse plugins.
-* There are several choices for free downloads of JDK 8:
+* There are several choices for free downloads of JDK 8 (the first two of these appear to be obsolete):
  * [http://openjdk.java.net/ OpenJDK] an open source JDK, works nicely if available for your platform (provided for most Linux distributions); 
  * [http://jdk.java.net Oracle's OpenJDK] production-ready open-source builds of the JDK from Oracle (limited range of platforms);
- * [http://www.oracle.com/technetwork/java/javase/downloads/index.html Oracle Java SE JDK] commercial JDK builds from Oracle, free downloads for most platforms;
+ * [http://www.oracle.com/technetwork/java/javase/downloads/index.html Oracle Java SE JDK] commercial JDK builds from Oracle (requires creating an account), free downloads for most platforms;
 
 As your system probably will have a more recent Java installed, 
@@ -37 +37 @@
 
 * On MacOSX terminal windows and compilers are part of the ''Xcode'' tool suite, available for free in the App Store (see  menu, on the upper left).
-* On Windows we recommend installing the [https://cygwin.com/install.html Cygwin] free, open-source gnu g++ and make utility. When using the downloader,  be certain to activate the developer section and select the ''gcc-g++:GNU Compiler Collection'' and ''make: The GNU Version of the ‘make’ utility''. Some people have managed to use Magnolia with native Windows tools without installing the Cygwin toolset.
+* On Windows it may now be possible to use Magnolia with the native developer tools. Otherwise we recommend installing the [https://cygwin.com/install.html Cygwin] free, open-source gnu g++ and make utility. When using the downloader,  be certain to activate the developer section and select the ''gcc-g++:GNU Compiler Collection'' and ''make: The GNU Version of the ‘make’ utility''. 
 
 == 2. Install Eclipse for Magnolia ==
@@ -43 +43 @@
 Create the directory ''magnolia'' (or whatever name you prefer) for storing Eclipse and your Magnolia workspace. This is recommended, but not necessary.
 
-There are several alternatives for downloading Eclipse. We recommend downloading an Eclipse package:
+There are several alternatives for downloading Eclipse. We recommend downloading an Eclipse package (do '''not''' use the Eclipse installer):
 * [https://www.eclipse.org/downloads/packages/release/oxygen/3a Eclipse Oxygen Package]  '''recommended''' release. 
 {{{#!comment
@@ -50 +50 @@
 Choose ''Eclipse IDE for C/C++ Developers''. 
 
-Depending on your operating system you may now have a {{{eclipse-cpp-oxygen-*.zip}}}, a {{{eclipse-cpp-oxygen-*.dmg}}}, or a {{{eclipse-cpp-oxygen-*.tar.gz}}} file.
+Depending on your operating system you may now have an {{{eclipse-cpp-oxygen-*.zip}}}, an {{{eclipse-cpp-oxygen-*.dmg}}}, or an {{{eclipse-cpp-oxygen-*.tar.gz}}} file.
 Unpack it, and install the software in the directory ''magnolia'' as planned.
 If you downloaded a tar file on Linux/BSD/Unix/MacOSX go to a terminal and move to the directory ''magnolia''. In the terminal unpack Eclipse by writing {{{tar xzfp [name of downloaded package]}}}.
@@ -57 +57 @@
 === Edit the file ''eclipse.ini'' ===
 
+NB! On current MacOS you need to start Eclipse (and immediately quit it) before editing the "eclipse.ini" file. Use something like {{{open -a Eclipse*.app --args -vm jdk8path}}} (where {{{jdk8path}}} is the path to the JDK 8 tools, see below).
+
 The file ''eclipse.ini'' is a normal text file which is somewhere in the newly unpackaged directory.
 
@@ -64 +66 @@
 <the path to your JDK 8>
 }}}
-The path to the JDK may be something like {{{C:\Program Files\Java\jdk1.8.0_144\bin}}} on Windows, {{{/Library/Java/JavaVirtualMachines/jdk1.8.0_201.jdk/Contents/Home/bin}}} on MacOS, or {{{/opt/java-jdk-1.8.0.102/bin}}} on Linux. 
+The path to JDK 8 {{{jdk8path}}} may be something like {{{C:\Program Files\Java\jdk1.8.0_144\bin}}} on Windows, {{{/System/Library/Frameworks/JavaVM.framework/Versions/A/Commands}}} on MacOS, or {{{/opt/java-jdk-1.8.0.102/bin}}} on Linux. 
 
 Then increase the heap size to 8g (or as much as you can afford given your machine's memory) by modifying the {{{-Xmx1024m}}} line in the ''eclipse.ini'' file:
@@ -116 +118 @@
 Installing Rascal may give some warnings/errors about package conflicts. 
 In the "Install Remediation Page" select "Update my installation to be compatible with the items being installed" (second option).
-This will typically remove {{{C/C++ Remote Launch}}} and {{{™ Terminal}}}  package from Eclipse and will normally be sufficient to get Rascal to install.
+This will typically remove {{{C/C++ Remote Launch}}} and {{{TM Terminal}}}  package from Eclipse and will normally be sufficient to get Rascal to install.
 
 You do not need to restart Eclipse yet.
@@ -124 +126 @@
 Install "Subclipse" from the ''Eclipse Marketplace…'' in the ''Help'' menu.
 
+Untick {{{JavaHL}}} in the list of packages that appear.
+
+{{{#!comment 
 If possible, you should choose a Subclipse version for compatibility with your system's subversion.
 On Linux/BSD/Unix/MacOSX you can find the subversion version by typing the command line {{{svn --version}}} in the terminal window. 
+}}}
 
 {{{#!comment
@@ -144 +150 @@
 
 
+{{{#!comment
 === Configuring Subversion (recommended) ===
 
@@ -149 +156 @@
 
 [[Image(sophus.png)]]
+}}}
 
 === Emacs Keys (optional) ===