sdk-manual: Updated Eclipse information

Fixed [YOCTO #11970]

Updated the field description for "Specify Sysroot Location" to
note that the user can have this either downloaded or built and
the ramifications of using a downloaded root filesystem.

Updated the "Deploying and Debugging the Application" steps for
both supported Eclipse versions to tell the user what to do if
a browse operation fails or times out.

(From yocto-docs rev: 623000af186cb5632af551f95384d4c96d4d6c54)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

1 files changed, 34 insertions, 7 deletions

diff --git a/documentation/sdk-manual/sdk-working-projects.xml b/documentation/sdk-manual/sdk-working-projects.xml
index da83b1a7cf..8b89c29f4a 100644
--- a/documentation/sdk-manual/sdk-working-projects.xml
+++ b/documentation/sdk-manual/sdk-working-projects.xml
@@ -942,7 +942,15 @@
                                     </para>
                                     <para>This location depends on where you
                                     separately extracted and installed the
-                                    target filesystem.
+                                    target filesystem when you either built
+                                    it or downloaded it.
+                                    <note>
+                                        If you downloaded the root filesystem
+                                        for the target hardware rather than
+                                        built it, you must download the
+                                        <filename>sato-sdk</filename> image
+                                        in order to build any c/c++ projects.
+                                    </note>
                                     As an example, suppose you prepared an
                                     image using the steps in the
                                     <ulink url='https://wiki.yoctoproject.org/wiki/TipsAndTricks/RunningEclipseAgainstBuiltImage'>wiki</ulink>.
@@ -1360,7 +1368,7 @@
                             by clicking on "new".</para></listitem>
                         <listitem><para>Select <filename>SSH</filename>, which
                             means Secure Socket Shell and then click "OK".
-                            Optionally, you can select an TCF connection
+                            Optionally, you can select a TCF connection
                             instead.
                             </para></listitem>
                         <listitem><para>
@@ -1413,11 +1421,30 @@
                             Eclipse is helpful in that it auto fills your
                             application name for you assuming you browsed to a
                             directory.
-                            <note>
-                                If you are prompted to provide a username and
-                                to optionally set a password, be sure you
-                                provide "root" as the username and you leave
-                                the password field blank.
+                            <note><title>Tips</title>
+                                <itemizedlist>
+                                    <listitem><para>
+                                    If you are prompted to provide a username
+                                    and to optionally set a password, be sure
+                                    you provide "root" as the username and you
+                                    leave the password field blank.
+                                    </para></listitem>
+                                    <listitem><para>
+                                    If browsing to a directory fails or times
+                                    out, but you can
+                                    <filename>ssh</filename> into your QEMU
+                                    or target from the command line and you
+                                    have proxies set up, it is likely that
+                                    Eclipse is sending the SSH traffic to a
+                                    proxy.
+                                    In this case, either use TCF , or click on
+                                    "Configure proxy settings" in the
+                                    connection dialog and add the target IP
+                                    address to the "bypass proxy" section.
+                                    You might also need to change
+                                    "Active Provider" from Native to Manual.
+                                    </para></listitem>
+                                </itemizedlist>
                             </note>
                             </para></listitem>
                         <listitem><para>