import-layers/yocto-poky/documentation/ref-manual/ref-manual.xml

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
[<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] >

<book id='ref-manual' lang='en'
      xmlns:xi="http://www.w3.org/2003/XInclude"
      xmlns="http://docbook.org/ns/docbook"
      >
    <bookinfo>

        <mediaobject>
            <imageobject>
                <imagedata fileref='figures/poky-title.png'
                    format='SVG'
                    align='left' scalefit='1' width='100%'/>
            </imageobject>
        </mediaobject>

        <title>
            Yocto Project Reference Manual
        </title>

        <authorgroup>
            <author>
                <firstname>Scott</firstname> <surname>Rifenbark</surname>
                <affiliation>
                    <orgname>Scotty's Documentation Services, INC</orgname>
                </affiliation>
                <email>srifenbark@gmail.com</email>
            </author>

        </authorgroup>

        <revhistory>
            <revision>
                <revnumber>4.0+git</revnumber>
                <date>24 November 2010</date>
                <revremark>Released with the Yocto Project 0.9 Release</revremark>
            </revision>
            <revision>
                <revnumber>1.0</revnumber>
                <date>6 April 2011</date>
                <revremark>Released with the Yocto Project 1.0 Release.</revremark>
            </revision>
            <revision>
                <revnumber>1.0.1</revnumber>
                <date>23 May 2011</date>
                <revremark>Released with the Yocto Project 1.0.1 Release.</revremark>
            </revision>
            <revision>
                <revnumber>1.1</revnumber>
                <date>6 October 2011</date>
                <revremark>Released with the Yocto Project 1.1 Release.</revremark>
            </revision>
            <revision>
                <revnumber>1.2</revnumber>
                <date>April 2012</date>
                <revremark>Released with the Yocto Project 1.2 Release.</revremark>
            </revision>
            <revision>
                <revnumber>1.3</revnumber>
                <date>October 2012</date>
                <revremark>Released with the Yocto Project 1.3 Release.</revremark>
            </revision>
            <revision>
                <revnumber>1.4</revnumber>
                <date>April 2013</date>
                <revremark>Released with the Yocto Project 1.4 Release.</revremark>
            </revision>
            <revision>
                <revnumber>1.5</revnumber>
                <date>October 2013</date>
                <revremark>Released with the Yocto Project 1.5 Release.</revremark>
            </revision>
            <revision>
                <revnumber>1.5.1</revnumber>
                <date>January 2014</date>
                <revremark>Released with the Yocto Project 1.5.1 Release.</revremark>
            </revision>
            <revision>
                <revnumber>1.6</revnumber>
                <date>April 2014</date>
                <revremark>Released with the Yocto Project 1.6 Release.</revremark>
            </revision>
            <revision>
                <revnumber>1.7</revnumber>
                <date>October 2014</date>
                <revremark>Released with the Yocto Project 1.7 Release.</revremark>
            </revision>
            <revision>
                <revnumber>1.8</revnumber>
                <date>April 2015</date>
                <revremark>Released with the Yocto Project 1.8 Release.</revremark>
            </revision>
            <revision>
                <revnumber>2.0</revnumber>
                <date>October 2015</date>
                <revremark>Released with the Yocto Project 2.0 Release.</revremark>
            </revision>
            <revision>
                <revnumber>2.1</revnumber>
                <date>April 2016</date>
                <revremark>Released with the Yocto Project 2.1 Release.</revremark>
            </revision>
            <revision>
                <revnumber>2.2</revnumber>
                <date>October 2016</date>
                <revremark>Released with the Yocto Project 2.2 Release.</revremark>
            </revision>
            <revision>
                <revnumber>2.3</revnumber>
                <date>May 2017</date>
                <revremark>Released with the Yocto Project 2.3 Release.</revremark>
            </revision>
            <revision>
                <revnumber>2.4</revnumber>
                <date>October 2017</date>
                <revremark>Released with the Yocto Project 2.4 Release.</revremark>
            </revision>
            <revision>
                <revnumber>2.4.1</revnumber>
                <date>January 2018</date>
                <revremark>Released with the Yocto Project 2.4.1 Release.</revremark>
            </revision>
            <revision>
                <revnumber>2.4.2</revnumber>
                <date>March 2018</date>
                <revremark>Released with the Yocto Project 2.4.2 Release.</revremark>
            </revision>
        </revhistory>

    <copyright>
      <year>&COPYRIGHT_YEAR;</year>
      <holder>Linux Foundation</holder>
    </copyright>

    <legalnotice>
      <para>
        Permission is granted to copy, distribute and/or modify this document under
        the terms of the <ulink type="http" url="http://creativecommons.org/licenses/by-sa/2.0/uk/">Creative Commons Attribution-Share Alike 2.0 UK: England &amp; Wales</ulink> as published by Creative Commons.
      </para>
           <note><title>Manual Notes</title>
               <itemizedlist>
                   <listitem><para>
                       This version of the
                       <emphasis>Yocto Project Reference Manual</emphasis>
                       is for the &YOCTO_DOC_VERSION; release of the
                       Yocto Project.
                       To be sure you have the latest version of the manual
                       for this release, use the manual from the
                       <ulink url='&YOCTO_HOME_URL;/documentation'>Yocto Project documentation page</ulink>.
                       </para></listitem>
                   <listitem><para>
                       For manuals associated with other releases of the Yocto
                       Project, go to the
                       <ulink url='&YOCTO_HOME_URL;/documentation'>Yocto Project documentation page</ulink>
                       and use the drop-down "Active Releases" button
                       and choose the manual associated with the desired
                       Yocto Project.
                       </para></listitem>
                   <listitem><para>
                        To report any inaccuracies or problems with this
                        manual, send an email to the Yocto Project
                        discussion group at
                        <filename>yocto@yoctoproject.com</filename> or log into
                        the freenode <filename>#yocto</filename> channel.
                        </para></listitem>
               </itemizedlist>
           </note>
    </legalnotice>

    </bookinfo>

    <xi:include href="introduction.xml"/>

    <xi:include href="usingpoky.xml"/>

    <xi:include href="ref-development-environment.xml"/>

    <xi:include href="technical-details.xml"/>

    <xi:include href="ref-release-process.xml"/>

    <xi:include href="migration.xml"/>

    <xi:include href="ref-structure.xml"/>

    <xi:include href="ref-classes.xml"/>

    <xi:include href="ref-tasks.xml"/>

    <xi:include href="ref-devtool-reference.xml"/>

    <xi:include href="ref-kickstart.xml"/>

    <xi:include href="ref-qa-checks.xml"/>

    <xi:include href="ref-images.xml"/>

    <xi:include href="ref-features.xml"/>

    <xi:include href="ref-variables.xml"/>

    <xi:include href="ref-varlocality.xml"/>

    <xi:include href="faq.xml"/>

    <xi:include href="resources.xml"/>

<!--    <index id='index'>
      <title>Index</title>
    </index>
-->

</book>
<!--
vim: expandtab tw=80 ts=4
-->