1 files changed, 23 insertions, 28 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 077935a..a8b2934 100644
--- a/doc/book-enea-linux-user-guide/doc/using_eclipse.xml
+++ b/doc/book-enea-linux-user-guide/doc/using_eclipse.xml
@@ -5,35 +5,34 @@
   <section id="install_eclipse">
     <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>
+    <note>
+      <para>Yocto Eclipse Plugins are discontinued, with the last Yocto version that provides them
+        being Yocto 2.5.</para>
+    </note>
 
-    <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
+    <para>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:
+        (eSDK)</ulink> documentation.</para>
+
+    <para>The installation instructions provided in Chapter 5.2.1.1 are no longer valid, please follow the 
+      steps below in order to install Eclipse Oxygen:
     </para>
 
     <orderedlist>
       <listitem>
-        <para>Download Eclipse Oxygen archive from this link, by selecting the correct architecture:<ulink
+        <para>Download the <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>).
+       Eclipse Oxygen archive</ulink>. Make sure to select the correct architecture in the link provided, 
+       e.g. <filename>eclipse-cpp-oxygen-2-linux-gtk-x86_64.tar.gz</filename>.
         </para>
       </listitem>
 
       <listitem>
-        <para>Decompress the Eclipse archive in your home directory and start the IDE:
+        <para>Unzip 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 
+  $ ~/eclipse/eclipse
             </programlisting>
         </para>
       </listitem>
@@ -43,21 +42,17 @@
               Oxygen.
           </para>
       </listitem>
-
     </orderedlist>
 
-    <para>
-        <note>
-            For compatibility reasons, only use JDK version 1.8 on your host.
+    <note>
+      <para>For compatibility reasons, only use JDK version 1.8 on your host.</para>
         </note>
-    </para>
   </section>
 
   <section id="install_yocto">
-    <title>Installing Yocto Plug-ins</title>
+    <title>Installing Yocto Plugins</title>
 
-    <para>To install the Yocto Plugins in Eclipse, follow the instructions in
-        <ulink 
+    <para>To install the Yocto Plugins in Eclipse, follow the instructions in the <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.
@@ -217,11 +212,11 @@ root 329 0.0 0.2 1864824 2600 ? Ssl 12:47 0:08 /usr/sbin/tcf-agent -d -L- -l0</p
       </orderedlist>
 
       <tip>
-        <para>More details on how to configure the cross-compiler can be found
+        <para>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">Yocto
-        Project Application Development and the Extensible Software Development Kit
-        (eSDK)</ulink>.
+        Project Application Development and Extensible Software Development Kit
+        (eSDK) Manual</ulink>.
         </para>
 
         <para>There is also a good cheat sheet available in Eclipse, under
@@ -672,7 +667,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>