diff options
-rw-r--r-- | documentation/adt-manual/adt-eclipse.xml | 62 | ||||
-rw-r--r-- | documentation/adt-manual/adt-prepare.xml | 10 |
2 files changed, 49 insertions, 23 deletions
diff --git a/documentation/adt-manual/adt-eclipse.xml b/documentation/adt-manual/adt-eclipse.xml index cb642ebed7..dcc201cdc8 100644 --- a/documentation/adt-manual/adt-eclipse.xml +++ b/documentation/adt-manual/adt-eclipse.xml | |||
@@ -41,7 +41,7 @@ | |||
41 | <title>Installing the Eclipse IDE</title> | 41 | <title>Installing the Eclipse IDE</title> |
42 | 42 | ||
43 | <para> | 43 | <para> |
44 | It is recommended that you have the Indigo 3.7 version of the | 44 | It is recommended that you have the Indigo 3.7.2 version of the |
45 | Eclipse IDE installed on your development system. | 45 | Eclipse IDE installed on your development system. |
46 | If you don’t have this version, you can find it at | 46 | If you don’t have this version, you can find it at |
47 | <ulink url='&ECLIPSE_MAIN_URL;'></ulink>. | 47 | <ulink url='&ECLIPSE_MAIN_URL;'></ulink>. |
@@ -106,6 +106,8 @@ | |||
106 | <listitem><para>Expand the box next to <filename>Programming Languages</filename> | 106 | <listitem><para>Expand the box next to <filename>Programming Languages</filename> |
107 | and select the <filename>Autotools Support for CDT (incubation)</filename> | 107 | and select the <filename>Autotools Support for CDT (incubation)</filename> |
108 | and <filename>C/C++ Development Tools</filename> boxes.</para></listitem> | 108 | and <filename>C/C++ Development Tools</filename> boxes.</para></listitem> |
109 | <listitem><para>Expand the box next to "Linux Tools" and select the | ||
110 | "LTTng - Linux Tracing Toolkit(incubation)" boxes.</para></listitem> | ||
109 | <listitem><para>Complete the installation and restart the Eclipse IDE.</para></listitem> | 111 | <listitem><para>Complete the installation and restart the Eclipse IDE.</para></listitem> |
110 | <listitem><para>After the Eclipse IDE restarts and from the Workbench, select | 112 | <listitem><para>After the Eclipse IDE restarts and from the Workbench, select |
111 | "Install New Software" from the "Help" pull-down menu.</para></listitem> | 113 | "Install New Software" from the "Help" pull-down menu.</para></listitem> |
@@ -144,19 +146,19 @@ | |||
144 | <title>Installing or Accessing the Eclipse Yocto Plug-in</title> | 146 | <title>Installing or Accessing the Eclipse Yocto Plug-in</title> |
145 | 147 | ||
146 | <para> | 148 | <para> |
147 | You can install the Eclipse Yocto Plug-in into the Eclipse application | 149 | You can install the Eclipse Yocto Plug-in into the Eclipse IDE |
148 | one of two ways: using the Eclipse IDE and installing the plug-in as new software, or | 150 | one of two ways: use the Yocto Project update site to install the pre-built plug-in, |
149 | using a built zip file. | 151 | or build and install the plug-in from the latest source code. |
150 | If you don't want to permanently install the plug-in but just want to try it out | 152 | If you don't want to permanently install the plug-in but just want to try it out |
151 | within the Eclipse environment, you can import the plug-in project from the | 153 | within the Eclipse environment, you can import the plug-in project from the |
152 | Yocto Project source repositories. | 154 | Yocto Project source repositories. |
153 | </para> | 155 | </para> |
154 | 156 | ||
155 | <section id='new-software'> | 157 | <section id='new-software'> |
156 | <title>Installing the Plug-in as New Software</title> | 158 | <title>Installing the Pre-built Plug-in from the Yocto Project Eclipse Update Site</title> |
157 | 159 | ||
158 | <para> | 160 | <para> |
159 | To install the Eclipse Yocto Plug-in as new software directly into the Eclipse IDE, | 161 | To install the Eclipse Yocto Plug-in from the update site, |
160 | follow these steps: | 162 | follow these steps: |
161 | <orderedlist> | 163 | <orderedlist> |
162 | <listitem><para>Start up the Eclipse IDE.</para></listitem> | 164 | <listitem><para>Start up the Eclipse IDE.</para></listitem> |
@@ -179,10 +181,9 @@ | |||
179 | </section> | 181 | </section> |
180 | 182 | ||
181 | <section id='zip-file-method'> | 183 | <section id='zip-file-method'> |
182 | <title>Installing the Plug-in from a Zip File</title> | 184 | <title>Installing the Plug-in Using the Latest Source Code</title> |
183 | <para> | 185 | <para> |
184 | To install the Eclipse Yocto Plug-in by building and installing a plug-in | 186 | To install the Eclipse Yocto Plug-in from the latest source code, follow these steps: |
185 | zip file, follow these steps: | ||
186 | <orderedlist> | 187 | <orderedlist> |
187 | <listitem><para>Open a shell and create a Git repository with: | 188 | <listitem><para>Open a shell and create a Git repository with: |
188 | <literallayout class='monospaced'> | 189 | <literallayout class='monospaced'> |
@@ -257,9 +258,9 @@ | |||
257 | and then click "Next".</para></listitem> | 258 | and then click "Next".</para></listitem> |
258 | <listitem><para>Select the root directory and browse to | 259 | <listitem><para>Select the root directory and browse to |
259 | <filename>~/yocto-eclipse/plugins</filename>.</para></listitem> | 260 | <filename>~/yocto-eclipse/plugins</filename>.</para></listitem> |
260 | <listitem><para>There will be three things there. | 261 | <listitem><para>Three plug-ins exist: "org.yocto.bc.ui", "org.yocto.sdk.ide", and |
261 | Select each one and install one at a time. | 262 | "org.yocto.sdk.remotetools". |
262 | Do all three.</para></listitem> | 263 | Select and import all of them.</para></listitem> |
263 | </orderedlist> | 264 | </orderedlist> |
264 | </para> | 265 | </para> |
265 | 266 | ||
@@ -585,11 +586,11 @@ | |||
585 | <ulink url='&YOCTO_GIT_URL;/cgit/cgit.cgi/oprofileui/'></ulink>. | 586 | <ulink url='&YOCTO_GIT_URL;/cgit/cgit.cgi/oprofileui/'></ulink>. |
586 | <note>The <filename>oprofile-server</filename> is installed by default on | 587 | <note>The <filename>oprofile-server</filename> is installed by default on |
587 | the <filename>core-image-sato-sdk</filename> image.</note></para></listitem> | 588 | the <filename>core-image-sato-sdk</filename> image.</note></para></listitem> |
588 | <listitem><para><emphasis><filename>Lttng-ust</filename>:</emphasis> Selecting this tool runs | 589 | <listitem><para><emphasis><filename>Lttng-ust</filename>:</emphasis> Selecting this tool runs |
589 | <filename>usttrace</filename> on the remote target, transfers the output data back to the | 590 | <filename>usttrace</filename> on the remote target, transfers the output data back |
590 | local host machine, and uses <filename>lttv-gui</filename> to graphically display the output. | 591 | to the local host machine, and uses the <filename>lttng</filename> Eclipse plug-in to |
591 | The <filename>lttv-gui</filename> must be installed on the local host machine to use this tool. | 592 | graphically display the output. |
592 | For information on how to use <filename>lttng</filename> to trace an application, see | 593 | For information on how to use <filename>lttng</filename> to trace an application, see |
593 | <ulink url='http://lttng.org/files/ust/manual/ust.html'></ulink>.</para> | 594 | <ulink url='http://lttng.org/files/ust/manual/ust.html'></ulink>.</para> |
594 | <para>For <filename>Application</filename>, you must supply the absolute path name of the | 595 | <para>For <filename>Application</filename>, you must supply the absolute path name of the |
595 | application to be traced by user mode <filename>lttng</filename>. | 596 | application to be traced by user mode <filename>lttng</filename>. |
@@ -597,7 +598,32 @@ | |||
597 | <filename>usttrace /path/to/foo</filename> on the remote target to trace the | 598 | <filename>usttrace /path/to/foo</filename> on the remote target to trace the |
598 | program <filename>/path/to/foo</filename>.</para> | 599 | program <filename>/path/to/foo</filename>.</para> |
599 | <para><filename>Argument</filename> is passed to <filename>usttrace</filename> | 600 | <para><filename>Argument</filename> is passed to <filename>usttrace</filename> |
600 | running on the remote target.</para></listitem> | 601 | running on the remote target.</para> |
602 | <para>Before you use the <filename>lttng-ust</filename> tool, you need to setup | ||
603 | the <filename>lttng</filename> Eclipse plug-in and create a <filename>lttng</filename> | ||
604 | project. | ||
605 | Do the following: | ||
606 | <orderedlist> | ||
607 | <listitem><para>Follow these | ||
608 | <ulink url='http://wiki.eclipse.org/Linux_Tools_Project/LTTng#Downloading_and_installing_the_LTTng_parser_library'>instructions</ulink> | ||
609 | to download and install the <filename>lttng</filename> parser library. | ||
610 | </para></listitem> | ||
611 | <listitem><para>Select <filename>Window -> Open Perspective -> Other</filename> | ||
612 | and then select <filename>LTTng</filename>.</para></listitem> | ||
613 | <listitem><para>Click <filename>OK</filename> to change the Eclipse perspective | ||
614 | into the <filename>LTTng</filename> perspective.</para></listitem> | ||
615 | <listitem><para>Create a new <filename>LTTng</filename> project by selecting | ||
616 | <filename>File -> New -> Project</filename>.</para></listitem> | ||
617 | <listitem><para>Choose <filename>LTTng -> LTTng Project</filename>.</para></listitem> | ||
618 | <listitem><para>Click <filename>YoctoTools -> lttng-ust</filename> to start user mode | ||
619 | <filename>lttng</filename> on the remote target.</para></listitem> | ||
620 | </orderedlist></para> | ||
621 | <para>After the output data has been transferred from the remote target back to the local | ||
622 | host machine, new traces will be imported into the selected <filename>LTTng</filename> project. | ||
623 | Then you can go to the <filename>LTTng</filename> project, right click the imported | ||
624 | trace, and set the trace type as the <filename>LTTng</filename> kernel trace. | ||
625 | Finally, right click the imported trace and select <filename>Open</filename> | ||
626 | to display the data graphically.</para></listitem> | ||
601 | <listitem><para><emphasis><filename>PowerTOP</filename>:</emphasis> Selecting this tool runs | 627 | <listitem><para><emphasis><filename>PowerTOP</filename>:</emphasis> Selecting this tool runs |
602 | <filename>powertop</filename> on the remote target machine and displays the results in a | 628 | <filename>powertop</filename> on the remote target machine and displays the results in a |
603 | new view called <filename>powertop</filename>.</para> | 629 | new view called <filename>powertop</filename>.</para> |
diff --git a/documentation/adt-manual/adt-prepare.xml b/documentation/adt-manual/adt-prepare.xml index 9880fcc7d1..3ced7f6ded 100644 --- a/documentation/adt-manual/adt-prepare.xml +++ b/documentation/adt-manual/adt-prepare.xml | |||
@@ -168,7 +168,7 @@ | |||
168 | After you have configured the <filename>adt_installer.conf</filename> file, | 168 | After you have configured the <filename>adt_installer.conf</filename> file, |
169 | run the installer using the following command: | 169 | run the installer using the following command: |
170 | <literallayout class='monospaced'> | 170 | <literallayout class='monospaced'> |
171 | $ adt_installer | 171 | $ ./adt_installer |
172 | </literallayout> | 172 | </literallayout> |
173 | </para> | 173 | </para> |
174 | 174 | ||
@@ -384,11 +384,11 @@ | |||
384 | <listitem><para>Set up the cross-development environment as described in the | 384 | <listitem><para>Set up the cross-development environment as described in the |
385 | "<link linkend='setting-up-the-cross-development-environment'>Setting | 385 | "<link linkend='setting-up-the-cross-development-environment'>Setting |
386 | Up the Cross-Development Environment</link>" section.</para></listitem> | 386 | Up the Cross-Development Environment</link>" section.</para></listitem> |
387 | <listitem><para>Get the <filename>tcf-agent</filename> source code, which is | 387 | <listitem><para>Get the <filename>tcf-agent</filename> source code using |
388 | stored using the Subversion SCM, using the following command: | 388 | the following commands: |
389 | <literallayout class='monospaced'> | 389 | <literallayout class='monospaced'> |
390 | $ svn checkout svn://dev.eclipse.org/svnroot/dsdp/org.eclipse.tm.tcf/trunk/agent \ | 390 | $ git clone http://git.eclipse.org/gitroot/tcf/org.eclipse.tcf.agent.git |
391 | <-r #rev_number> | 391 | $ cd agent |
392 | </literallayout></para></listitem> | 392 | </literallayout></para></listitem> |
393 | <listitem><para>Modify the <filename>Makefile.inc</filename> file | 393 | <listitem><para>Modify the <filename>Makefile.inc</filename> file |
394 | for the cross-compilation environment by setting the | 394 | for the cross-compilation environment by setting the |