1 files changed, 157 insertions, 0 deletions

diff --git a/doc/book-enea-linux-user-guide/doc/preface.xml b/doc/book-enea-linux-user-guide/doc/preface.xml
new file mode 100644
index 0000000..1752ff5
--- /dev/null
+++ b/doc/book-enea-linux-user-guide/doc/preface.xml
@@ -0,0 +1,157 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<chapter id="preface">
+  <title>Preface</title>
+
+  <section id="guide_purpose">
+    <title>The Purpose of this Guide</title>
+
+    <para>This guide is intended for all Enea Linux developers who want to
+    configure and build customized Linux kernel images for embedded system
+    targets, but also for developers who want to build and run applications in
+    Enea Linux.</para>
+
+    <note>
+      <para>Always read the README files and the Release Information before
+      this User's Guide.</para>
+    </note>
+
+    <para>The recommended order of operations for developers are:</para>
+
+    <orderedlist>
+      <listitem>
+        <para>Receive information from Enea and read the initial documentation
+        online.</para>
+      </listitem>
+
+      <listitem>
+        <para>Update the development host with the needed packages, then
+        download and install Enea Linux.</para>
+      </listitem>
+
+      <listitem>
+        <para>Download and install the Cross-Compilation Toolchain.</para>
+      </listitem>
+
+      <listitem>
+        <para>Start developing your own Enea Linux applications or building
+        your own Enea Linux images.</para>
+      </listitem>
+    </orderedlist>
+
+    <para>It is assumed that the reader of this User's Guide has a deep
+    knowledge about Linux, how to configure the Linux kernel, and knows how to
+    use the Yocto build system. The variety of information provided in this
+    guide can serve as a quick start introduction to the standards and best
+    practices we share with the Linux community. In this spirit, Enea provides
+    <ulink url="http://www.enea.com/training">training courses</ulink>.</para>
+
+    <para>With this Enea Linux release you have a verified and easy to install
+    board support package for a number of supported hardware types. The board
+    support package includes a set of prebuilt utilities, accessible and setup
+    to rapidly reach your objectives as a developer. In this regard, the
+    support package contains a Linux kernel and root file system, a Software
+    Development Kit (SDK) which includes the cross-compilation toolchain, a
+    variety of tools and scripts for development and customization, and if
+    opted for, a user-friendly Eclipse version with an integrated development
+    environment.</para>
+
+    <para>The documentation for Enea Linux consists of generic and
+    distribution-specific documents. The generic documents are common for
+    several Enea Linux distributions. The main documents are:</para>
+
+    <table>
+      <tgroup cols="2">
+        <tbody>
+          <row>
+            <entry>Enea Linux Release Information</entry>
+
+            <entry>A distribution specific document detailing what the current
+            release contains, including supported features, references to
+            other documentation, known problems and limitations, and Enea
+            support contact information.</entry>
+          </row>
+
+          <row>
+            <entry>README files for the distribution</entry>
+
+            <entry>Distribution specific documents that serve as an
+            introduction and how-to for this release, where you also find
+            target specific commands and parameters, replacing the generic
+            examples in the User's Guide. These files also point to Build,
+            Boot, and Configuration information details for this
+            distribution.</entry>
+          </row>
+
+          <row>
+            <entry>Enea Linux User's Guide</entry>
+
+            <entry>The generic manual for developers who build Linux kernels
+            for embedded systems or use prebuilt Linux kernels.</entry>
+          </row>
+
+          <row>
+            <entry>Enea Linux Open Source Report</entry>
+
+            <entry>The distribution specific list of software packages with
+            corresponding Open Source Licenses, that are included in the Enea
+            Linux distribution.</entry>
+          </row>
+
+          <row>
+            <entry>Enea Linux Security Report</entry>
+
+            <entry>The release specific document listing the CVEs affecting
+            this distribuition.</entry>
+          </row>
+        </tbody>
+      </tgroup>
+    </table>
+
+    <para>See also the following generic documentation related to the Yocto
+    project, which actually is based on OpenEmbedded.</para>
+
+    <itemizedlist>
+      <listitem>
+        <para><ulink
+        url="https://www.yoctoproject.org/documentation/archived">https://www.yoctoproject.org/documentation/archived</ulink>
+        - Yocto project documentation. Search for the Yocto version included
+        in your Enea Linux distribution.</para>
+      </listitem>
+    </itemizedlist>
+
+    <itemizedlist>
+      <listitem>
+        <para><ulink
+        url="http://docs.openembedded.org">http://docs.openembedded.org</ulink>
+        - OpenEmbedded documentation, useful since Yocto is based on
+        OpenEmbedded.</para>
+      </listitem>
+    </itemizedlist>
+
+    <itemizedlist>
+      <listitem>
+        <para><ulink
+        url="https://wiki.yoctoproject.org/wiki">https://wiki.yoctoproject.org/wiki
+        </ulink>- Yocto Wiki, useful information for Yocto users</para>
+      </listitem>
+    </itemizedlist>
+
+    <itemizedlist>
+      <listitem>
+        <para><ulink
+        url="https://wiki.yoctoproject.org/wiki/Ptest">https://wiki.yoctoproject.org/wiki/Ptest</ulink>
+        - Ptest wiki. Ptest was initiated by Enea, for building, installing
+        and running package test suites</para>
+      </listitem>
+    </itemizedlist>
+
+    <itemizedlist>
+      <listitem>
+        <para><ulink
+        url="http://www.crashcourse.ca/wiki/index.php/Poky_Variable_Glossary">http://www.crashcourse.ca/wiki/index.php/Poky_Variable_Glossary</ulink>
+        - Explanation of some Yocto/Poky variables used in the build
+        configuration files.</para>
+      </listitem>
+    </itemizedlist>
+  </section>
+</chapter>
\ No newline at end of file