From b26854f76b2fa8d44937bdae0664b1a24b2c7e78 Mon Sep 17 00:00:00 2001
From: Thomas Lundström <thomas.lundstrom@enea.com>
Date: Wed, 22 Jun 2016 19:24:31 +0200
Subject: Initial commit

---
 .../doc/getting_enea_linux.xml                     | 103 +++++++++++++++++++++
 1 file changed, 103 insertions(+)
 create mode 100644 doc/book-enea-linux-release-info/doc/getting_enea_linux.xml

(limited to 'doc/book-enea-linux-release-info/doc/getting_enea_linux.xml')

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..f25c1a5
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/getting_enea_linux.xml
@@ -0,0 +1,103 @@
+<?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:</para>
+
+        <para><programlisting>$ curl https://storage.googleapis.com/git-repo-downloads/repo &gt; ~/bin/repo
+$ chmod a+x ~/bin/repo</programlisting>The instruction assumes that ~/bin
+        exists and is included in the PATH variable.</para>
+      </listitem>
+
+      <listitem>
+        <para>Use the repo tool to download the source:<remark>FIXME: Before
+        final release the tag for the manifest must be set in Makefile as
+        MANIFESTHASH, typically something like refs/tags/EL6. Before that, a
+        generic branch name is used instead, e.g. krogoth in
+        Makefile</remark></para>
+
+        <para><programlisting>$ mkdir enea-linux
+$ cd enea-linux
+$ repo init -u	<xi:include href="../../s_docsrc_common/pardoc-distro.xml"
+              xmlns:xi="http://www.w3.org/2001/XInclude"
+              xpointer="element(EneaLinux_MANIFESTURL/1)" /> \
+            -b <xi:include href="../../s_docsrc_common/pardoc-distro.xml"
+              xmlns:xi="http://www.w3.org/2001/XInclude"
+              xpointer="element(EneaLinux_MANIFESTHASH/1)" /> \
+            -m &lt;manifest file&gt;
+$ repo sync</programlisting></para>
+
+        <para>The parameter &lt;manifest file&gt; depends on the target. See
+        the following table:</para>
+
+        <informaltable>
+          <tgroup cols="2">
+            <thead>
+              <row>
+                <entry align="center">Target</entry>
+
+                <entry align="center">Manifest file</entry>
+              </row>
+            </thead>
+
+            <tbody>
+              <row>
+                <entry>P2041RDB</entry>
+
+                <entry><para>p2041rdb/default.xml</para></entry>
+              </row>
+            </tbody>
+          </tgroup>
+        </informaltable>
+      </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>
\ No newline at end of file
-- 
cgit v1.2.3-54-g00ecf