summaryrefslogtreecommitdiffstats
path: root/doc/book-enea-linux-release-info/doc/getting_enea_linux.xml
blob: 055be15e5350b65a5ab5da254a1041f0d705c6f3 (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
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<chapter id="relinfo-getting-enea-linux">
  <title>Getting Enea Linux</title>

  <section id="relinfo-getting-pre-built-images">
    <title>Getting Pre-built Binaries</title>

    <para>Application developers will download pre-complied images from the
    Enea Portal or will receive prebuilt images from the platform developers.
    For further information on this see <olink
    targetdoc="book_enea_linux_app_dev_guide"
    targetptr="book_enea_linux_app_dev_guide">Enea Linux Application
    Development Guide</olink>.</para>
  </section>

  <section id="relinfo-getting-source">
    <title>Getting the Source</title>

    <para>The source for this Enea Linux release is available for cloning from
    a set of Git repositories. To manage the different repositories, Google's
    repo tool is used. The basic idea is to store a list with (repo-URL,
    version) tuples in a separate file, known as the manifest. The repo tool
    is then used to traverse the list and clone the specified versions of the
    repositories. See <ulink
    url="https://code.google.com/p/git-repo/">https://code.google.com/p/git-repo/</ulink>
    for more info.</para>

    <para>To use repo tool to download the source for Enea Linux, follow the
    steps below:</para>

    <orderedlist>
      <listitem>
        <para>Make sure that the repo tool is installed. If not, follow the
        instructions below. The instruction assumes a suitable place in your
        PATH to use. You might change that.<remark>INFO: Below is include of
        ID "eltf-getting-repo-install-command" from
        eltf_params_updated.xml</remark></para>

        <xi:include href="eltf_params_updated.xml"
                    xmlns:xi="http://www.w3.org/2001/XInclude"
                    xpointer="element(eltf-getting-repo-install-command/1)" />
      </listitem>

      <listitem>
        <para>Use the repo tool to download the source: Please define MACHINE
        to your target, uncomment and use one of the MACHINE lines listed
        here,<remark>Below is the "machine_list" programlisting in
        machine_list_generated.xml created by the make system by extracting
        from the manifest</remark></para>

        <xi:include href="machine_list_generated.xml"
                    xmlns:xi="http://www.w3.org/2001/XInclude"
                    xpointer="element(machine-list/1)" />

        <para>and use the repo command below:<remark> Below is include of ID
        "eltf-repo-cloning-enea-linux" from eltf_params_updated.xml. Here the
        $MACHINE shall be given!</remark></para>

        <xi:include href="eltf_params_updated.xml"
                    xmlns:xi="http://www.w3.org/2001/XInclude"
                    xpointer="element(eltf-repo-cloning-enea-linux/1)" />
      </listitem>
    </orderedlist>

    <para>The source code is now downloaded. Current directory will contain a
    README file with instructions on how to build the distro and boot the
    target. For convenience, these instructions are also copied into this
    document. See <xref linkend="relinfo-build-boot" />.</para>

    <para>It is not necessary to explicitly clone the manifest repository
    since that is done automatically by the repo tool. To see the current
    manifest, e.g. to get a list of the repositories, use the following
    command:</para>

    <programlisting>$ repo manifest</programlisting>

    <remark>The UG should be updated with instructions on how to add
    customisations. That section should also contain some more info about the
    manifest: The manifest templates, using a branch instead of the tag EL6,
    ... When this is done a reference from here should be added.</remark>
  </section>
</chapter>