summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/dev-manual')
-rw-r--r--documentation/dev-manual/dev-manual-model.xml94
1 files changed, 27 insertions, 67 deletions
diff --git a/documentation/dev-manual/dev-manual-model.xml b/documentation/dev-manual/dev-manual-model.xml
index 334ae16276..761ac982a5 100644
--- a/documentation/dev-manual/dev-manual-model.xml
+++ b/documentation/dev-manual/dev-manual-model.xml
@@ -749,12 +749,8 @@
749 <para> 749 <para>
750 You can install the Eclipse Yocto Plug-in into the Eclipse 750 You can install the Eclipse Yocto Plug-in into the Eclipse
751 IDE one of two ways: use the Yocto Project's Eclipse 751 IDE one of two ways: use the Yocto Project's Eclipse
752 Update site to install the pre-built plug-in, or build and 752 Update site to install the pre-built plug-in or build and
753 install the plug-in from the latest source code. 753 install the plug-in from the latest source code.
754 If you do not want to permanently install the plug-in but
755 just want to try it out within the Eclipse environment,
756 you can import the plug-in project from the Yocto Project's
757 Source Repositories.
758 </para> 754 </para>
759 755
760 <section id='new-software'> 756 <section id='new-software'>
@@ -807,10 +803,29 @@
807 To install the Eclipse Yocto Plug-in from the latest 803 To install the Eclipse Yocto Plug-in from the latest
808 source code, follow these steps: 804 source code, follow these steps:
809 <orderedlist> 805 <orderedlist>
810 <listitem><para>Open a shell and create a Git 806 <listitem><para>Be sure your development system
807 is not using OpenJDK to build the plug-in
808 by doing the following:
809 <orderedlist>
810 <listitem><para>Use the Oracle JDK.
811 If you don't have that, go to
812 <ulink url='http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html'></ulink>
813 and download the appropriate tarball
814 for your development system and
815 extract it into your home directory.
816 </para></listitem>
817 <listitem><para>In the shell you are going
818 to do your work, export the location of
819 the Oracle Java as follows:
820 <literallayout class='monospaced'>
821 export PATH=~/jdk1.7.0_40/bin:$PATH
822 </literallayout></para></listitem>
823 </orderedlist></para></listitem>
824 <listitem><para>In the same shell, create a Git
811 repository with: 825 repository with:
812 <literallayout class='monospaced'> 826 <literallayout class='monospaced'>
813 $ git clone git://git.yoctoproject.org/eclipse-poky-kepler yocto-eclipse 827 $ cd ~
828 $ git clone git://git.yoctoproject.org/eclipse-poky-kepler
814 </literallayout> 829 </literallayout>
815 <note> 830 <note>
816 If you are using Juno, the repository is 831 If you are using Juno, the repository is
@@ -818,19 +833,19 @@
818 <filename>git://git.yoctoproject.org/eclipse-poky-juno</filename>. 833 <filename>git://git.yoctoproject.org/eclipse-poky-juno</filename>.
819 </note> 834 </note>
820 For this example, the repository is named 835 For this example, the repository is named
821 <filename>~/yocto-eclipse</filename>. 836 <filename>~/eclipse-poky-kepler</filename>.
822 </para></listitem> 837 </para></listitem>
823 <listitem><para>Change to the directory where you 838 <listitem><para>Change to the directory where you
824 set up the Git repository: 839 set up the Git repository:
825 <literallayout class='monospaced'> 840 <literallayout class='monospaced'>
826 $ cd ~/yocto-eclipse 841 $ cd ~/eclipse-poky-kepler
827 </literallayout></para></listitem> 842 </literallayout></para></listitem>
828 <listitem><para>Be sure you are in the right branch 843 <listitem><para>Be sure you are in the right branch
829 for your Git repository. 844 for your Git repository.
830 For this release set the branch to 845 For this release set the branch to
831 <filename>&DISTRO_NAME;</filename>: 846 <filename>&DISTRO_NAME;</filename>:
832 <literallayout class='monospaced'> 847 <literallayout class='monospaced'>
833 $ git checkout -b &DISTRO_NAME; origin/&DISTRO_NAME; 848 $ git checkout &DISTRO_NAME;
834 </literallayout></para></listitem> 849 </literallayout></para></listitem>
835 <listitem><para>Change to the 850 <listitem><para>Change to the
836 <filename>scripts</filename> 851 <filename>scripts</filename>
@@ -857,7 +872,7 @@
857 Here is an example that uses the 872 Here is an example that uses the
858 <filename>&DISTRO_NAME;</filename> branch: 873 <filename>&DISTRO_NAME;</filename> branch:
859 <literallayout class='monospaced'> 874 <literallayout class='monospaced'>
860 $ ECLIPSE_HOME=/home/scottrif/yocto-eclipse/scripts/eclipse ./build.sh &DISTRO_NAME; &DISTRO_NAME; 875 $ ECLIPSE_HOME=/home/scottrif/eclipse-poky-kepler/scripts/eclipse ./build.sh &DISTRO_NAME; &DISTRO_NAME;
861 </literallayout> 876 </literallayout>
862 After running the script, the file 877 After running the script, the file
863 <filename>org.yocto.sdk-&lt;release&gt;-&lt;date&gt;-archive.zip</filename> 878 <filename>org.yocto.sdk-&lt;release&gt;-&lt;date&gt;-archive.zip</filename>
@@ -879,7 +894,7 @@
879 </para></listitem> 894 </para></listitem>
880 <listitem><para>Click through the "Okay" buttons. 895 <listitem><para>Click through the "Okay" buttons.
881 </para></listitem> 896 </para></listitem>
882 <listitem><para>Check the box next to the new entry 897 <listitem><para>Check the boxes
883 in the installation window and complete 898 in the installation window and complete
884 the installation.</para></listitem> 899 the installation.</para></listitem>
885 <listitem><para>Restart the Eclipse IDE if 900 <listitem><para>Restart the Eclipse IDE if
@@ -893,61 +908,6 @@
893 "<link linkend='configuring-the-eclipse-yocto-plug-in'>Configuring the Eclipse Yocto Plug-in</link>" 908 "<link linkend='configuring-the-eclipse-yocto-plug-in'>Configuring the Eclipse Yocto Plug-in</link>"
894 section.</para> 909 section.</para>
895 </section> 910 </section>
896
897 <section id='yocto-project-source'>
898 <title>Importing the Plug-in Project into the Eclipse Environment</title>
899
900 <para>
901 Importing the Eclipse Yocto Plug-in project from the
902 Yocto Project source repositories is useful when you
903 want to try out the latest plug-in from the tip of
904 plug-in's development tree.
905 It is important to understand when you import the
906 plug-in you are not installing it into the Eclipse
907 application.
908 Rather, you are importing the project and just using it.
909 </para>
910
911 <para>
912 To import the plug-in project, follow these steps:
913 <orderedlist>
914 <listitem><para>Open a shell and create a Git
915 repository with:
916 <literallayout class='monospaced'>
917 $ git clone git://git.yoctoproject.org/eclipse-poky-kepler yocto-eclipse
918 </literallayout>
919 <note>
920 The Juno repository is located at
921 <filename>git://git.yoctoproject.org/eclipse-poky-juno</filename>
922 </note>
923 For this example, the repository is named
924 <filename>~/yocto-eclipse</filename>.
925 </para></listitem>
926 <listitem><para>In Eclipse, select "Import" from
927 the "File" menu.</para></listitem>
928 <listitem><para>Expand the "General" box and select
929 "existing projects into workspace" and then
930 click "Next".</para></listitem>
931 <listitem><para>Select the root directory and
932 browse to
933 <filename>~/yocto-eclipse/plugins</filename>.
934 </para></listitem>
935 <listitem><para>Three plug-ins exist:
936 <filename>org.yocto.bc.ui</filename>,
937 <filename>org.yocto.sdk.ide</filename>, and
938 <filename>org.yocto.sdk.remotetools</filename>.
939 Select and import all of them.</para></listitem>
940 </orderedlist>
941 </para>
942
943 <para>
944 The left navigation pane in the Eclipse application
945 shows the default projects.
946 Right-click on one of these projects and run it as an
947 Eclipse application to bring up a second instance of
948 Eclipse IDE that has the Yocto Plug-in.
949 </para>
950 </section>
951 </section> 911 </section>
952 912
953 <section id='configuring-the-eclipse-yocto-plug-in'> 913 <section id='configuring-the-eclipse-yocto-plug-in'>