From cd4739e1d25fcd2f37bbb687cc1427d488eb6ee5 Mon Sep 17 00:00:00 2001
From: Miruna Paun <Miruna.Paun@enea.com>
Date: Fri, 14 Apr 2017 17:58:15 +0200
Subject: First draft of Virt profile to master branch

LXCR-7536 Updating to the CR that contains info
about this new profile documentation as a whole.

Signed-off-by: Miruna Paun <Miruna.Paun@enea.com>
---
 .../doc/getting_enea_linux.xml                     | 84 ++++++++++++++++++++++
 1 file changed, 84 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..055be15
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/getting_enea_linux.xml
@@ -0,0 +1,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>
\ No newline at end of file
-- 
cgit v1.2.3-54-g00ecf