[oe-commits] org.oe.documentation usermanual: creating of new distribution

[hrw commit]

usermanual: creating of new distribution

Author: hrw at openembedded.org
Branch: org.openembedded.documentation
Revision: c92c658dcb80c344af3f12b87ab431bc55cf74e7
ViewMTN: http://monotone.openembedded.org/revision.psp?id=c92c658dcb80c344af3f12b87ab431bc55cf74e7
Files:
1
usermanual/usermanual.xml
Diffs:

#
# mt diff -r3f29d540676e04a729e0f31ccd64f5b6f5668eff -rc92c658dcb80c344af3f12b87ab431bc55cf74e7
#
# 
# 
# patch "usermanual/usermanual.xml"
#  from [53fa6b0906fe9a3bc37f1eda98d5d9fd31001efc]
#    to [c8b7cb24b8f17ef7bf5291a3e280903a8ab20787]
# 
============================================================
--- usermanual/usermanual.xml	53fa6b0906fe9a3bc37f1eda98d5d9fd31001efc
+++ usermanual/usermanual.xml	c8b7cb24b8f17ef7bf5291a3e280903a8ab20787
@@ -308,7 +308,51 @@ and the resulting <command>task-base</co
 
         <section>
             <title>Creating a new Distribution</title>
-            <para>This section is a stub, help us by expanding it</para>
+<para>
+Creating a new distribution is not complicated. Config need to be created
+in /conf/distro directory. What has to be inside?
+<itemizedlist>
+    <listitem><para><command>DISTRO_VERSION</command> so users will know which version of distribution they use.</para></listitem>
+    <listitem><para><command>DISTRO_TYPE</command> (release/debug) variable is used in some recipes to enable/disable some features - for example kernel output on screen for "debug" builds.</para></listitem>
+    <listitem><para>Type of libc used: will it be glibc (<command>TARGET_OS</command> = "linux") or uclibc (<command>TARGET_OS</command> = "linux-uclibc")?</para></listitem>
+    <listitem><para>Toolchain versions - for example gcc 3.4.4 based distro will have:
+            <screen>
+PREFERRED_PROVIDERS += " virtual/${TARGET_PREFIX}gcc-initial:gcc-cross-initial"
+PREFERRED_PROVIDERS += " virtual/${TARGET_PREFIX}gcc:gcc-cross"
+PREFERRED_PROVIDERS += " virtual/${TARGET_PREFIX}g++:gcc-cross"
+
+PREFERRED_VERSION_binutils = "2.16"
+PREFERRED_VERSION_binutils-cross = "2.16"
+
+PREFERRED_VERSION_gcc = "3.4.4"
+PREFERRED_VERSION_gcc-cross = "3.4.4"
+PREFERRED_VERSION_gcc-initial-cross = "3.4.4"
+            </screen>
+    </para></listitem>
+    <listitem><para> <command>DISTRO_FEATURES</command> which describe which features distro has. More about it in <link linkend="task-base">task-base</link> section.</para></listitem>
+    <listitem><para>Versions of kernels used for supported devices:
+            <screen>
+PREFERRED_VERSION_linux-omap1_omap5912osk ?= "2.6.18+git"
+PREFERRED_VERSION_linux-openzaurus ?= "2.6.17"
+            </screen>
+    </para></listitem>
+    <listitem><para>To get more stable build it is good to make use of sane-srcdates.inc file which contain working SRCDATE for many of floating recipes.
+            <screen>
+require conf/distro/include/sane-srcdates.inc
+            </screen>
+            It also should have global <command>SRCDATE</command> value set (format is ISO date: YYYYMMDD):
+            <screen>
+SRCDATE = "20061014"
+            </screen>
+    </para></listitem>
+</itemizedlist>
+
+</para>
+
+<para>
+
+</para>
+
         </section>
 
         <section>