summaryrefslogtreecommitdiffstats
path: root/documentation/book-enea-linux-users-guide/doc/install_enealinux.xml
blob: ab151a73bae805cab1a9822b62ca6d0e2e2b7323 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<section id="enea-linux-download">
  <title>Download and Install Enea Linux</title>

  <para>Download the needed tarballs from <xi:include
  href="../../docsrc_common/pardoc-distro.xml"
  xmlns:xi="http://www.w3.org/2001/XInclude"
  xpointer="element(ULINK_ENEA_LINUX_URL/1)" />.</para>

  <variablelist>
    <varlistentry>
      <term>Enea Linux</term>

      <listitem>
        <para>Enea-Linux-<xi:include
        href="../../docsrc_common/pardoc-distro.xml"
        xmlns:xi="http://www.w3.org/2001/XInclude"
        xpointer="element(EneaLinux_REL_VER/1)" />.tar.gz</para>

        <para>The Enea Linux distribution tarball contains:</para>

        <itemizedlist spacing="compact">
          <listitem condition="redhat_buildtools">
            <para>a buildtools toolchain<indexterm>
                <primary>buildtools toolchain</primary>
              </indexterm><indexterm>
                <primary>toolchain</primary>

                <secondary>cross-compilation</secondary>
              </indexterm> in a self-extracting archive with extension
            <literal>.sh</literal></para>
          </listitem>

          <listitem>
            <para><filename>poky</filename> <indexterm>
                <primary>poky</primary>
              </indexterm> - directory containing bitbake, conf files, recipes
            (.bb, .bbappend, .inc files), packages, patches, scripts, and poky
            documentation</para>
          </listitem>
        </itemizedlist>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>Documentation</term>

      <listitem>
        <simplelist>
          <member>Enea-Linux-doc_<xi:include
          href="../../docsrc_common/pardoc-distro.xml"
          xmlns:xi="http://www.w3.org/2001/XInclude"
          xpointer="element(EneaLinux_REL_VER/1)" />[-docupdate&lt;version&gt;].tar.gz</member>

          <member>If available, take the docupdate tarball to get the latest
          documentation.</member>
        </simplelist>

        <para>The Enea Linux documentation tarball contains:</para>

        <itemizedlist spacing="compact">
          <listitem>
            <para><filename>README.htm</filename> - index linking to the Enea
            Linux documentation</para>
          </listitem>

          <listitem>
            <para><filename>README.release</filename> - overview of release
            contents and quick installation guide</para>
          </listitem>

          <listitem>
            <para><filename>documentation</filename> <indexterm>
                <primary>documentation</primary>
              </indexterm>- Enea Linux documentation in PDF and HTML format:
            Open Source Reports, Release Information, User's Guide<phrase
            condition="rtguide">, Real-Time Guide</phrase>.</para>
          </listitem>
        </itemizedlist>
      </listitem>
    </varlistentry>

    <varlistentry condition="eclipse">
      <term>Eclipse tools</term>

      <listitem>
        <para>Enea-Linux-Eclipse_<xi:include
        href="../../docsrc_common/pardoc-distro.xml"
        xmlns:xi="http://www.w3.org/2001/XInclude"
        xpointer="element(EneaLinux_REL_VER_ECLIPSE/1)" />.tar.gz.</para>

        <para>Optional but recommended tools for Enea Linux. The tarball
        contains:</para>

        <itemizedlist spacing="compact">
          <listitem>
            <para><filename>eclipse</filename> - the Eclipse IDE version
            <phrase>4.3 </phrase><phrase>Kepler</phrase>, with eclipse
            executable and plug-ins (CDT, RSE, SDK, ...)</para>
          </listitem>

          <listitem>
            <para><filename>yocto-plugins</filename> - additional eclipse
            plug-ins with tools from the Yocto Project Application Development
            Toolkit (ADT)</para>
          </listitem>
        </itemizedlist>

        <para>The Eclipse related documentation - Eclipse Open Source Report,
        and the Eclipse chapter in the User's Guide - is available in the Enea
        Linux documentation tarball.</para>
      </listitem>
    </varlistentry>
  </variablelist>

  <para>Unpack the Enea Linux distribution tarball:</para>

  <programlisting>$ tar xzf Enea-Linux-<xi:include
      href="../../docsrc_common/pardoc-distro.xml"
      xmlns:xi="http://www.w3.org/2001/XInclude"
      xpointer="element(EneaLinux_REL_VER/1)" />.tar.gz</programlisting>

  <para>Unpack the Enea Linux documentation tarball:</para>

  <programlisting>$ tar xzf Enea-Linux-doc_<xi:include
      href="../../docsrc_common/pardoc-distro.xml"
      xmlns:xi="http://www.w3.org/2001/XInclude"
      xpointer="element(EneaLinux_REL_VER/1)" />.tar.gz
# or, if available:
$ tar xzf Enea-Linux-doc_<xi:include
      href="../../docsrc_common/pardoc-distro.xml"
      xmlns:xi="http://www.w3.org/2001/XInclude"
      xpointer="element(EneaLinux_REL_VER/1)" />-docupdate&lt;version&gt;.tar.gz</programlisting>

  <para condition="eclipse">If you want to use the Eclipse IDE and the
  application development tools, unpack the Eclipse tarball:</para>

  <programlisting condition="eclipse">$ tar xzf Enea-Linux-Eclipse_<xi:include
      href="../../docsrc_common/pardoc-distro.xml"
      xmlns:xi="http://www.w3.org/2001/XInclude"
      xpointer="element(EneaLinux_REL_VER_ECLIPSE/1)" />.tar.gz</programlisting>

  <para>Optionally <link linkend="enea-linux-install-cc-toolchain">Install the
  cross-compilation toolchain</link>.</para>
</section>