el7_std: Added Preface and Introduction chapter to doc

Signed-off-by: Dragos Motrea <Dragos.Motrea@enea.com>

2 files changed, 192 insertions, 7 deletions

diff --git a/doc/book-enea-linux-user-guide/doc/introduction.xml b/doc/book-enea-linux-user-guide/doc/introduction.xml
index 79d15d6..ccbdb0a 100644
--- a/doc/book-enea-linux-user-guide/doc/introduction.xml
+++ b/doc/book-enea-linux-user-guide/doc/introduction.xml
@@ -2,9 +2,54 @@
 <chapter id="intro">
   <title>Introduction</title>
 
-  <section id="placeholder_id_a">
-    <title></title>
+  <para>Welcome to Enea<trademark class="registered"></trademark> Linux</para>
 
-    <para></para>
-  </section>
+  <para>Enea<trademark class="registered"></trademark> Linux is based on the
+  open source configuration system Yocto which is becoming the de facto
+  standard for building and configuring embedded Linux. Yocto development is
+  coordinated by the Yocto Project which was initiated by the Linux
+  Foundation.</para>
+
+  <para>The Yocto-based development environment of Enea Linux allows you to
+  build embedded Linux kernels and tool chains on a Linux host. It aids you in
+  customizing embedded Linux kernels for a specific hardware architecture, and
+  in building and troubleshooting embedded Linux applications on targets or
+  emulated in QEMU.</para>
+
+  <para>Enea Linux also provides verified and easily installed board support
+  packages (BSP) for a number of hardware architectures. Each BSP includes a
+  Linux kernel and a root filesystem (rootfs), plus a number of packages that
+  can be extended on request.</para>
+
+  <para>Providing true open source Linux with customer interests in mind, is
+  the cornerstone for Enea when supplying Enea Linux. We provide:</para>
+
+  <itemizedlist>
+    <listitem>
+      <para>A Yocto compatible environment, familiar for those who have used
+      Yocto from any other distribution.</para>
+    </listitem>
+
+    <listitem>
+      <para>The Enea Linux environment is fully independent from hardware
+      vendor leverage and does not push for a particular hardware
+      architecture.</para>
+    </listitem>
+
+    <listitem>
+      <para>Enea has initiated and contributes the ptest package test
+      framework to the Yocto Project. Enea also uses ptest to verify the
+      packages on target.</para>
+    </listitem>
+  </itemizedlist>
+
+  <para>By using, testing Yocto and sharing Linux patches with upstream
+  projects, Enea assists the open source community in providing mature
+  software in less time. As an Enea Linux user, you are welcome to contribute
+  to the global development of Linux by propagating your Linux patches through
+  Enea.</para>
+
+  <para>Enea can also assist a customer by analyzing source code and producing
+  valid open source reports, as required by the community when open source
+  components are used.</para>
 </chapter>
\ No newline at end of file
diff --git a/doc/book-enea-linux-user-guide/doc/preface.xml b/doc/book-enea-linux-user-guide/doc/preface.xml
index 2c80732..49373b2 100644
--- a/doc/book-enea-linux-user-guide/doc/preface.xml
+++ b/doc/book-enea-linux-user-guide/doc/preface.xml
@@ -2,9 +2,149 @@
 <chapter id="preface">
   <title>Preface</title>
 
-  <section id="placeholder_id_b">
-    <title></title>
+  <section id="guide_purpose">
+    <title>The Purpose of This Guide</title>
 
-    <para></para>
+    <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>
+        </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