summaryrefslogtreecommitdiffstats
path: root/doc/book-enea-linux-release-info/doc/getting_enea_linux.xml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/book-enea-linux-release-info/doc/getting_enea_linux.xml')
-rw-r--r--doc/book-enea-linux-release-info/doc/getting_enea_linux.xml84
1 files changed, 84 insertions, 0 deletions
diff --git a/doc/book-enea-linux-release-info/doc/getting_enea_linux.xml b/doc/book-enea-linux-release-info/doc/getting_enea_linux.xml
new file mode 100644
index 0000000..055be15
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/getting_enea_linux.xml
@@ -0,0 +1,84 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="relinfo-getting-enea-linux">
5 <title>Getting Enea Linux</title>
6
7 <section id="relinfo-getting-pre-built-images">
8 <title>Getting Pre-built Binaries</title>
9
10 <para>Application developers will download pre-complied images from the
11 Enea Portal or will receive prebuilt images from the platform developers.
12 For further information on this see <olink
13 targetdoc="book_enea_linux_app_dev_guide"
14 targetptr="book_enea_linux_app_dev_guide">Enea Linux Application
15 Development Guide</olink>.</para>
16 </section>
17
18 <section id="relinfo-getting-source">
19 <title>Getting the Source</title>
20
21 <para>The source for this Enea Linux release is available for cloning from
22 a set of Git repositories. To manage the different repositories, Google's
23 repo tool is used. The basic idea is to store a list with (repo-URL,
24 version) tuples in a separate file, known as the manifest. The repo tool
25 is then used to traverse the list and clone the specified versions of the
26 repositories. See <ulink
27 url="https://code.google.com/p/git-repo/">https://code.google.com/p/git-repo/</ulink>
28 for more info.</para>
29
30 <para>To use repo tool to download the source for Enea Linux, follow the
31 steps below:</para>
32
33 <orderedlist>
34 <listitem>
35 <para>Make sure that the repo tool is installed. If not, follow the
36 instructions below. The instruction assumes a suitable place in your
37 PATH to use. You might change that.<remark>INFO: Below is include of
38 ID "eltf-getting-repo-install-command" from
39 eltf_params_updated.xml</remark></para>
40
41 <xi:include href="eltf_params_updated.xml"
42 xmlns:xi="http://www.w3.org/2001/XInclude"
43 xpointer="element(eltf-getting-repo-install-command/1)" />
44 </listitem>
45
46 <listitem>
47 <para>Use the repo tool to download the source: Please define MACHINE
48 to your target, uncomment and use one of the MACHINE lines listed
49 here,<remark>Below is the "machine_list" programlisting in
50 machine_list_generated.xml created by the make system by extracting
51 from the manifest</remark></para>
52
53 <xi:include href="machine_list_generated.xml"
54 xmlns:xi="http://www.w3.org/2001/XInclude"
55 xpointer="element(machine-list/1)" />
56
57 <para>and use the repo command below:<remark> Below is include of ID
58 "eltf-repo-cloning-enea-linux" from eltf_params_updated.xml. Here the
59 $MACHINE shall be given!</remark></para>
60
61 <xi:include href="eltf_params_updated.xml"
62 xmlns:xi="http://www.w3.org/2001/XInclude"
63 xpointer="element(eltf-repo-cloning-enea-linux/1)" />
64 </listitem>
65 </orderedlist>
66
67 <para>The source code is now downloaded. Current directory will contain a
68 README file with instructions on how to build the distro and boot the
69 target. For convenience, these instructions are also copied into this
70 document. See <xref linkend="relinfo-build-boot" />.</para>
71
72 <para>It is not necessary to explicitly clone the manifest repository
73 since that is done automatically by the repo tool. To see the current
74 manifest, e.g. to get a list of the repositories, use the following
75 command:</para>
76
77 <programlisting>$ repo manifest</programlisting>
78
79 <remark>The UG should be updated with instructions on how to add
80 customisations. That section should also contain some more info about the
81 manifest: The manifest templates, using a branch instead of the tag EL6,
82 ... When this is done a reference from here should be added.</remark>
83 </section>
84</chapter> \ No newline at end of file