diff --git a/documentation/sdk-manual/sdk-eclipse-project.xml b/documentation/sdk-manual/sdk-eclipse-project.xml
index 5ad9c45ae7..c45d0874af 100644
--- a/documentation/sdk-manual/sdk-eclipse-project.xml
+++ b/documentation/sdk-manual/sdk-eclipse-project.xml
@@ -19,8 +19,8 @@
The following figure and supporting list summarize the
- application development general workflow that employs both the
- SDK Eclipse.
+ general workflow for application development that uses the
+ SDK within the Eclipse IDE.
@@ -259,15 +259,17 @@
Install the Software:
- Accept the default "cpp-oxygen" directory and
- click "Install".
- Accept any license agreements and approve any
- certificates.
+ Click "Install" to begin the installation.
+ Accept all the certificates and any license
+ agreements.
+ Click "Install" again to finish the installation.
Launch Oxygen:
- Click the "Launch" button and accept the
- default "workspace".
+ Accept the default "workspace" and click the
+ "Launch" button.
+ You should see the Eclipse welcome page from which
+ can click "workbench" to enter your workspace.
@@ -278,17 +280,29 @@
Follow these steps to configure the Oxygen Eclipse IDE.
-
- Depending on how you installed Eclipse and what
- you have already done, some of the options will
- not appear.
- If you cannot find an option as directed by the
- manual, it has already been installed.
+ Notes
+
+
+ Depending on how you installed Eclipse and what
+ you have already done, some of the options will
+ not appear.
+ If you cannot find an option as directed by the
+ manual, it has already been installed.
+
+
+ If you want to see all items regardless of
+ whether they are installed or not, deselect the
+ "Hide items that are already installed"
+ check box.
+
+
Be sure Eclipse is running and you are in your
workbench.
+ Just click "workbench" if you are not in your
+ default workspace.
Select "Install New Software" from the "Help"
@@ -341,7 +355,7 @@
You can install the Eclipse Yocto Plug-in into the
Eclipse IDE one of two ways: use the Yocto Project's
- Eclipse Update site to install the pre-built plug-in
+ Eclipse Update site to install the pre-built plug-in,
or build and install the plug-in from the latest
source code.
@@ -370,12 +384,10 @@
name in the "Name" field.
- Click "OK" to have the entry added
- to the "Work with:" drop-down list.
-
-
- Select the entry for the plug-in
- from the "Work with:" drop-down list.
+ Click "OK" to have the entry automatically
+ populate the "Work with:" field and to have
+ the items for installation appear in the window
+ below.
Check the boxes next to the following:
@@ -407,8 +419,13 @@
latest source code, follow these steps:
- Be sure your development system
- has JDK 1.8+
+ Be sure your build host has JDK version 1.8
+ or greater.
+ On a Linux build host you can determine the
+ version using the following command:
+
+ $ java -version
+
Install X11-related packages:
@@ -428,12 +445,12 @@
Use Git to create the correct tag:
$ cd ~/eclipse-yocto
- $ git checkout -b oxygen/yocto-&DISTRO; remotes/origin/oxygen-master
+ $ git checkout -b oxygen/&DISTRO_NAME_NO_CAP; remotes/origin/oxygen/&DISTRO_NAME_NO_CAP;
This creates a local tag named
- oxygen/yocto-&DISTRO;
+ oxygen/&DISTRO_NAME_NO_CAP;
based on the branch
- origin/oxygen-master.
+ origin/oxygen/&DISTRO_NAME_NO_CAP;.
You are put into a detached HEAD state,
which is fine since you are only going to
be building and not developing.
@@ -467,11 +484,11 @@
Following is an example:
- $ ECLIPSE_HOME=/home/scottrif/eclipse-yocto/scripts/eclipse ./build.sh -l oxygen/yocto-&DISTRO; master yocto-&DISTRO; 2>&1 | tee build.log
+ $ ECLIPSE_HOME=/home/scottrif/eclipse-yocto/scripts/eclipse ./build.sh -l oxygen/&DISTRO_NAME_NO_CAP; master yocto-&DISTRO; 2>&1 | tee build.log
The previous example command adds the tag
you need for
- oxygen/yocto-&DISTRO;
+ oxygen/&DISTRO_NAME_NO_CAP;
to HEAD, then tells
the build script to use the local (-l) Git
checkout for the build.
@@ -553,7 +570,7 @@
To start, you need to do the following from within the
Eclipse IDE:
-
+
Choose "Preferences" from the "Window" menu to
display the Preferences Dialog.
@@ -562,7 +579,7 @@
Click "Yocto Project SDK" to display
the configuration screen.
-
+
The following sub-sections describe how to configure
the plug-in.
@@ -784,7 +801,7 @@
- Click the "Apply" and "OK" to save your plug-in
+ Click "Apply and Close" to save your plug-in
configurations.
@@ -822,17 +839,15 @@
click "Next".
- Expand
- Yocto Project SDK Autotools Project.
+ Expand "Yocto Project SDK Autotools Project".
- Select Hello World ANSI C Autotools Projects.
+ Select "Hello World ANSI C Autotools Projects".
This is an Autotools-based project based on a Yocto
template.
- Put a name in the
- Project name: field.
+ Put a name in the "Project name:" field.
Do not use hyphens as part of the name
(e.g. hello).
@@ -886,21 +901,15 @@
Make or verify your configurations for the
- project and click "OK".
+ project and click "Apply and Close".
- Right-click in the navigation pane and
- select "Reconfigure Project" from the pop-up menu.
+ Right-click in the navigation pane and select
+ "Reconfigure Project" from the pop-up menu.
This selection reconfigures the project by running
- autogen.sh in the workspace
- for your project.
- The script also runs
- libtoolize,
- aclocal,
- autoconf,
- autoheader,
- automake --a, and
- ./configure.
+ Autotools GNU utility programs
+ such as Autoconf, Automake, and so forth in the
+ workspace for your project.
Click on the "Console" tab beneath your source code
to see the results of reconfiguring your project.
@@ -914,7 +923,8 @@
To build the project select "Build All" from the
"Project" menu.
The console should update and you can note the
- cross-compiler you are using.
+ cross-compiler you are using (i.e.
+ i586-poky-linux-gcc in this example).
When building "Yocto Project SDK Autotools" projects,
the Eclipse IDE might display error messages for
@@ -934,8 +944,9 @@
File > New menu.
- In the "New Folder" Dialog, select "Link to
- alternate location (linked folder)".
+ In the "New Folder" Dialog, click the "Advanced"
+ button and then activate "Link to
+ alternate location (linked folder)" button.
Click "Browse" to navigate to the include
@@ -943,9 +954,6 @@
selected in the Yocto Project
configuration preferences.
-
- Click "OK".
-
Click "Finish" to save the linked folder.
@@ -988,8 +996,8 @@
rpcbind, follow the
suggestions to get the service running.
As an example, on a new Ubuntu 16.04 LTS
- installation, you must do the following in
- order to get QEMU to launch:
+ installation, you must do the following in a new
+ shell in order to get QEMU to launch:
$ sudo apt-get install rpcbind