summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/usermanual/chapters/metadata.xml107
1 files changed, 84 insertions, 23 deletions
diff --git a/docs/usermanual/chapters/metadata.xml b/docs/usermanual/chapters/metadata.xml
index f4cf3bc5e6..54fb523553 100644
--- a/docs/usermanual/chapters/metadata.xml
+++ b/docs/usermanual/chapters/metadata.xml
@@ -5,28 +5,89 @@
<section id="metadata_file_layout">
<title>File Layout</title>
- <para>OpenEmbedded has six directories three of them hold
- <application>BitBake</application> metadata.</para>
-
- <para>The <emphasis>conf</emphasis> directory is holding the bitbake.conf,
- machine and distribution configuration. bitbake.conf is read when
- <application>BitBake</application> is started and this will include among
- others a local.conf the machine and distribution configuration files.
- These files will be searched in the <command>BBPATH</command> environment
- variable.</para>
-
- <para><emphasis>classes</emphasis> is the directory holding
- <application>BitBake</application> bbclass. These classes can be inherited
- by the <application>BitBake</application> files. BitBake automatically
- inherits the base.bbclass on every parsed file. <command>BBPATH</command>
- is used to find the class.</para>
-
- <para>In <emphasis>packages</emphasis> the
- <application>BitBake</application> files are stored. For each task or
- application we have a directory. These directories store the real
- <application>BitBake</application> files. They are the ones ending with
- <emphasis>.bb</emphasis>. And for each application and version we have
- one.</para>
+ <para>The OpenEmbedded
+ directory, <filename>$OEBASE/openembedded/</filename>, has seven
+ directories, three of which hold
+ <application>BitBake</application> metadata.
+
+ <variablelist>
+ <varlistentry>
+ <term><filename>classes/</filename></term>
+ <listitem>
+ <para>Contains <application>BitBake</application>
+ <filename>.bbclass</filename> files. These classes can
+ be inherited by other <application>BitBake</application>
+ files. Every <application>BitBake</application>
+ <filename>.bb</filename> file automatically inherits the
+ <filename>base.bbclass</filename>. <varname>BBPATH</varname>
+ is used to find the <filename>.bbclass</filename> files.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><filename>conf/</filename></term>
+ <listitem>
+ <para>Contains the configuration files for OpenEmbedded.
+ The <filename>bitbake.conf</filename> is read when
+ <application>BitBake</application> is started and this will
+ include the <filename>local.conf</filename>, the machine and
+ distribution configuration files, among others. These files
+ will be located using the <varname>BBPATH</varname> environment
+ variable as a search path.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><filename>contrib/</filename></term>
+ <listitem>
+ <para>Contains miscellaneous scripts that do not
+ belong in the other directories.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><filename>docs/</filename></term>
+ <listitem>
+ <para>Contains the source for the user manual and other
+ documentation files.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><filename>files/</filename></term>
+ <listitem><para>Contains setup tables for populating
+ the <filename>/dev</filename> directory of various target images.
+ </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><filename>packages/</filename></term>
+ <listitem>
+ <para>Conatins all of the
+ <application>BitBake</application> <filename>.bb</filename>
+ files. There is a subdirectory for each task or application
+ and within that subdirectory is
+ a <application>BitBake</application> <filename>.bb</filename> file
+ for each supported version of an application or task.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><filename>site/</filename></term>
+ <listitem>
+ <para>Contains site configuration files for
+ the <application>autoconf</application>/<application>automake</application>
+ system.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
</section>
<section id="metadata_syntax">
@@ -126,4 +187,4 @@ FILES_${PN} += "/usr/weirdpath/importantfile.foo"
will get appended to the standard file-list, not replace the standard
one.</para>
</section>
-</chapter> \ No newline at end of file
+</chapter>