ref-manual; mega-manual: Edits to further define packaging process

In response to community input where developers were attempting to
locate information on how to write packages out to a directory
other than ${DEPLOY_DIR}/<package_type>, I updated the "Package
Feeds" section, added several new DEPLOY_DIR_* variables, updated
four classes, and updated four tasks.  Here are some details:

 * Made changes to the "Package Feeds" section to provide more
   accurate information in the package feeds directory structure
   used by the build system in build/tmp.  These changes included
   updating the figure itself and some explanatory text.

 * Updated the DEPLOY_DIR variable description.

 * Added new variable descriptions for DEPLOY_DIR_DEB, DEPLOY_DIR_IPK,
   DEPLOY_DIR_RPM, and DEPLOY_DIR_TAR.

 * Updated the related classes: package_deb, package_ipk, package_rpm,
   and package_tar.

 * Updated the related tasks: do_package_write_deb, do_package_write_ipk,
   do_package_write_rpm, and do_package_write_tar.

Reported-by: Trieu Nguyen <trieu.t.nguyen@intel.com>
(From yocto-docs rev: e8742267506bf9359346cfcd3965f762ed2c7d6f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2015-04-27 15:20:28 -07:00
committed by Richard Purdie
parent a2d770b58a
commit 6192753e9d
6 changed files with 252 additions and 53 deletions

View File

@@ -2263,11 +2263,12 @@
<para>
The <filename>package_deb</filename> class
provides support for creating packages that use the
<filename>.deb</filename> file format.
The class ensures the packages are written out to the
<filename>${</filename><link linkend='var-DEPLOY_DIR'><filename>DEPLOY_DIR</filename></link><filename>}/deb</filename>
directory in a <filename>.deb</filename> file format.
provides support for creating packages that use the Debian
(i.e. <filename>.deb</filename>) file format.
The class ensures the packages are written out in a
<filename>.deb</filename> file format to the
<filename>${</filename><link linkend='var-DEPLOY_DIR_DEB'><filename>DEPLOY_DIR_DEB</filename></link><filename>}</filename>
directory.
</para>
<para>
@@ -2284,11 +2285,12 @@
<para>
The <filename>package_ipk</filename> class
provides support for creating packages that use the
<filename>.ipk</filename> file format.
The class ensures the packages are written out to the
<filename>${</filename><link linkend='var-DEPLOY_DIR'><filename>DEPLOY_DIR</filename></link><filename>}/ipk</filename>
directory in a <filename>.ipk</filename> file format.
provides support for creating packages that use the IPK
(i.e. <filename>.ipk</filename>) file format.
The class ensures the packages are written out in a
<filename>.ipk</filename> file format to the
<filename>${</filename><link linkend='var-DEPLOY_DIR_IPK'><filename>DEPLOY_DIR_IPK</filename></link><filename>}</filename>
directory.
</para>
<para>
@@ -2305,11 +2307,12 @@
<para>
The <filename>package_rpm</filename> class
provides support for creating packages that use the
<filename>.rpm</filename> file format.
The class ensures the packages are written out to the
<filename>${</filename><link linkend='var-DEPLOY_DIR'><filename>DEPLOY_DIR</filename></link><filename>}/rpm</filename>
directory in a <filename>.rpm</filename> file format.
provides support for creating packages that use the RPM
(i.e. <filename>.rpm</filename>) file format.
The class ensures the packages are written out in a
<filename>.rpm</filename> file format to the
<filename>${</filename><link linkend='var-DEPLOY_DIR_RPM'><filename>DEPLOY_DIR_RPM</filename></link><filename>}</filename>
directory.
</para>
<para>
@@ -2324,19 +2327,13 @@
<section id='ref-classes-package_tar'>
<title><filename>package_tar.bbclass</filename></title>
<note><title>Warning</title>
The <filename>package_tar</filename> class is broken and is not
supported.
It is recommended that you do not use it.
</note>
<para>
The <filename>package_tar</filename>
class provides support for creating packages that use the
<filename>.tar</filename> file format.
The class ensures the packages are written out to the
<filename>${</filename><link linkend='var-DEPLOY_DIR'><filename>DEPLOY_DIR</filename></link><filename>}/tar</filename>
directory in a <filename>.tar</filename> file format.
The <filename>package_tar</filename> class
provides support for creating tarballs.
The class ensures the packages are written out in a
tarball format to the
<filename>${</filename><link linkend='var-DEPLOY_DIR_TAR'><filename>DEPLOY_DIR_TAR</filename></link><filename>}</filename>
directory.
</para>
<para>