Updated Yocto Plugins for Eclipse

Rewrite installation and configuration of Yocto
Eclipse plugins.

Change-Id: I0c94ea1a5c25d79ff10fa4a7f0b989778e44831c

1 files changed, 54 insertions, 56 deletions

diff --git a/doc/book-enea-linux-user-guide/doc/using_eclipse.xml b/doc/book-enea-linux-user-guide/doc/using_eclipse.xml
index f354399..077935a 100644
--- a/doc/book-enea-linux-user-guide/doc/using_eclipse.xml
+++ b/doc/book-enea-linux-user-guide/doc/using_eclipse.xml
@@ -3,72 +3,70 @@
   <title>Using Eclipse</title>
 
   <section id="install_eclipse">
-    <title>Installing Eclipse</title>
+    <title>Installing Oxygen Eclipse IDE</title>
+
+    <para>
+        <note>
+            Yocto Eclipse Plugins are discontinued and the last Yocto version that provides them
+            is Yocto 2.5.
+        </note>
+    </para>
+
+    <para>Installation and configuration of the Eclipse Oxygen IDE should be done following the
+        <ulink url="http://www.yoctoproject.org/docs/2.5/sdk-manual/sdk-manual.html#adt-eclipse">Yocto
+        Project Application Development and the Extensible Software Development Kit
+        (eSDK)</ulink> documentation, Chapter 5.
+    Instructions provided in Chapter 5.2.1.1 are no longer valid, so, please follow the 
+    steps below in order to install Eclipse Oxygen:
+    </para>
 
-    <para>For instructions on how to install Eclipse Oxygen, please refer to
-    the <ulink
-    url="http://www.yoctoproject.org/docs/2.5/sdk-manual/sdk-manual.html#adt-eclipse">Yocto
-    Project Software Development Kit (SDK) Developer's Guide</ulink>, chapter
-    4.3.2.1. Although the instructions listed there currently, refer to the
-    Neon release of Eclipse, the same steps still apply to the Oxygen release,
-    with some small differences:</para>
-
-    <itemizedlist>
+    <orderedlist>
       <listitem>
-        <para>In <emphasis role="bold">step 1</emphasis> from chapter
-        4.3.2.1.1, the URL for downloading Eclipse should be <ulink
-        url="http://www.eclipse.org/oxygen">http://www.eclipse.org/oxygen</ulink>
-        instead.</para>
+        <para>Download Eclipse Oxygen archive from this link, by selecting the correct architecture:<ulink
+        url="https://www.eclipse.org/downloads/packages/release/oxygen/2/eclipse-ide-cc-developers">
+        https://www.eclipse.org/downloads/packages/release/oxygen/2/eclipse-ide-cc-developers</ulink>
+        (i.e. <filename>eclipse-cpp-oxygen-2-linux-gtk-x86_64.tar.gz</filename>).
+        </para>
       </listitem>
 
       <listitem>
-        <para>In <emphasis role="bold">step 3</emphasis> from chapter
-        4.3.2.1.2, the correct option in the drop-down menu should look like:
-        <emphasis>Oxygen -
-        http://download.eclipse.org/releases/oxygen</emphasis>.</para>
+        <para>Decompress the Eclipse archive in your home directory and start the IDE:
+            <programlisting>
+  $ tar xf ~/Downloads/eclipse-cpp-oxygen-2-linux-gtk-x86_64.tar.gz -C ~/
+  $ ~/eclipse/eclipse 
+            </programlisting>
+        </para>
       </listitem>
 
       <listitem>
-        <para>In <emphasis role="bold">step 5</emphasis> from chapter
-        4.3.2.1.2, under the category <emphasis role="bold">Mobile and Device
-        Development</emphasis>, select <emphasis role="bold">C/C++ GDB
-        Hardware Debugging</emphasis> as well.</para>
+          <para>Proceed to Chapter 5.2.1.2 in the Yocto documentation and configure Eclipse with
+              Oxygen.
+          </para>
       </listitem>
-    </itemizedlist>
+
+    </orderedlist>
+
+    <para>
+        <note>
+            For compatibility reasons, only use JDK version 1.8 on your host.
+        </note>
+    </para>
   </section>
 
   <section id="install_yocto">
     <title>Installing Yocto Plug-ins</title>
 
-    <para>Retrieve the archive containing the Yocto Plug-ins from the Enea
-    Linux release location and save it on your local machine. The archive file
-    has the following format:
-    <filename>org.yocto.sdk-&lt;release&gt;-&lt;date&gt;-archive.zip</filename>.</para>
-
     <para>To install the Yocto Plugins in Eclipse, follow the instructions in
-    <ulink
-    url="http://www.yoctoproject.org/docs/2.5/sdk-manual/sdk-manual.html#adt-eclipse">chapter
-    4.3.2.1.3.2</ulink>. of the Yocto Manual, starting with <emphasis
-    role="bold">step 8</emphasis>. In <emphasis role="bold">step 12</emphasis>
-    use the local archive that you downloaded previously.</para>
-
-    <para>To make sure that all required packages have been installed, go to
-    the menu <emphasis role="bold">Help &gt; Install New Software &gt; Eclipse
-    version</emphasis>, and select the version you use (e.g. Oxygen), to add
-    any missing packages. You can also check what packages are currently
-    installed by pressing the <emphasis role="bold">What is Already
-    Installed?</emphasis> link, as seen below.</para>
-
-    <mediaobject>
-      <imageobject role="fo">
-        <imagedata align="center" contentwidth="600"
-                   fileref="images/install_new_sw.svg" />
-      </imageobject>
-
-      <imageobject role="html">
-        <imagedata align="center" fileref="images/install_new_sw.png" />
-      </imageobject>
-    </mediaobject>
+        <ulink 
+            url="http://www.yoctoproject.org/docs/2.5/sdk-manual/sdk-manual.html#oxygen-setting-up-the-eclipse-ide">
+        Yocto Project Application Development and the Extensible Software Development Kit
+        (eSDK)</ulink> documentation, Chapter 5.2.1.3.
+    </para>
+    <para>
+        You have the option of installing pre-built plugins from the Yocto Project Eclipse
+        update site (Chapter 5.2.1.3.1) or to install the plugins using the latest source code
+        (Chapter 5.2.1.3.2). We recommend for the first installation the use of pre-built plugins.
+    </para>
   </section>
 
   <section id="eclipse_remote_connection">
@@ -221,10 +219,10 @@ root 329 0.0 0.2 1864824 2600 ? Ssl 12:47 0:08 /usr/sbin/tcf-agent -d -L- -l0</p
       <tip>
         <para>More details on how to configure the cross-compiler can be found
         in the <ulink
-        url="http://www.yoctoproject.org/docs/2.5/sdk-manual/sdk-manual.html"><emphasis>Yocto
-        Project Software Development Kit (SDK) Developer's Guide
-        2.5</emphasis></ulink>. Change the Yocto version in the link if
-        needed.</para>
+        url="http://www.yoctoproject.org/docs/2.5/sdk-manual/sdk-manual.html">Yocto
+        Project Application Development and the Extensible Software Development Kit
+        (eSDK)</ulink>.
+        </para>
 
         <para>There is also a good cheat sheet available in Eclipse, under
         <emphasis role="bold">Help &gt; Cheat Sheets &gt; Yocto Project &gt;
@@ -674,7 +672,7 @@ root 329 0.0 0.2 1864824 2600 ? Ssl 12:47 0:08 /usr/sbin/tcf-agent -d -L- -l0</p
               role="bold">Browse</emphasis> button and select a location on
               the remote target. You need an active TCF connection to the
               target for the <emphasis role="bold">Browse</emphasis> button to
-              work (see chapter <emphasis role="bold">Setting up a TCF
+              work (see Chapter <emphasis role="bold">Setting up a TCF
               Connection from Eclipse</emphasis>). Note that you need to
               specify the path including the filename.</para>
             </listitem>