[yocto] [PATCH] documentation: remove all references to Hob
akuster808
akuster808 at gmail.com
Fri Mar 4 11:20:02 PST 2016
On 3/4/16 8:49 AM, Belen Barros Pena wrote:
> From: Belen Barros Pena <belen.barros.pena at intel.com>
>
> Hob and the packageinfo class have now been removed from the code base.
> This patch removes all references to:
>
> * Hob
> * meta-hob
> * packageinfo and
> * BBLAYERS_NON_REMOVABLE
>
> from the documentation.
the build appliance page refers to HOB. does it need to updated?
https://www.yoctoproject.org/documentation/build-appliance-manual
- armin
>
> So long, Hob, and thanks for all the fish.
>
> Signed-off-by: Belen Barros Pena <belen.barros.pena at intel.com>
> ---
> documentation/bsp-guide/bsp.xml | 5 --
> documentation/dev-manual/dev-manual-intro.xml | 5 --
> documentation/dev-manual/dev-manual-model.xml | 47 -------------------
> documentation/ref-manual/introduction.xml | 4 --
> documentation/ref-manual/migration.xml | 14 +-----
> documentation/ref-manual/ref-bitbake.xml | 2 +-
> documentation/ref-manual/ref-classes.xml | 16 -------
> documentation/ref-manual/ref-structure.xml | 3 +-
> documentation/ref-manual/ref-variables.xml | 54 ----------------------
> .../toaster-manual/toaster-manual-intro.xml | 19 --------
> 10 files changed, 3 insertions(+), 166 deletions(-)
>
> diff --git a/documentation/bsp-guide/bsp.xml b/documentation/bsp-guide/bsp.xml
> index ec39ec9..8cf2a1e 100644
> --- a/documentation/bsp-guide/bsp.xml
> +++ b/documentation/bsp-guide/bsp.xml
> @@ -1403,11 +1403,6 @@
> /usr/local/src/yocto/meta-yocto-bsp \
> /usr/local/src/yocto/meta-myarm \
> "
> -
> - BBLAYERS_NON_REMOVABLE ?= " \
> - /usr/local/src/yocto/meta \
> - /usr/local/src/yocto/meta-yocto \
> - "
> </literallayout>
> Adding the layer to this file allows the build system to build the BSP and
> the <filename>yocto-kernel</filename> tool to be able to find the layer and
> diff --git a/documentation/dev-manual/dev-manual-intro.xml b/documentation/dev-manual/dev-manual-intro.xml
> index e350882..5affa86 100644
> --- a/documentation/dev-manual/dev-manual-intro.xml
> +++ b/documentation/dev-manual/dev-manual-intro.xml
> @@ -169,11 +169,6 @@
> release of the Yocto Project.
> </para></listitem>
> <listitem><para><emphasis>
> - <ulink url='&YOCTO_HOME_URL;/tools-resources/projects/hob'>Hob</ulink>:</emphasis>
> - A graphical user interface for BitBake.
> - Hob's primary goal is to enable a user to perform common tasks more easily.
> - </para></listitem>
> - <listitem><para><emphasis>
> <ulink url='&YOCTO_HOME_URL;/tools-resources/projects/toaster'>Toaster</ulink>:</emphasis>
> An Application Programming Interface (API) and web-based
> interface to the OpenEmbedded build system, which uses
> diff --git a/documentation/dev-manual/dev-manual-model.xml b/documentation/dev-manual/dev-manual-model.xml
> index 984d08d..489547d 100644
> --- a/documentation/dev-manual/dev-manual-model.xml
> +++ b/documentation/dev-manual/dev-manual-model.xml
> @@ -48,12 +48,6 @@
> Toaster provides an efficient interface to the OpenEmbedded build
> that allows you to start builds and examine build statistics.
> </para></listitem>
> - <listitem><para><emphasis>Image Development using Hob:</emphasis>
> - You can use the <ulink url='&YOCTO_HOME_URL;/tools-resources/projects/hob'>Hob</ulink>
> - to build custom operating system images within the build
> - environment.
> - Hob provides an efficient interface to the OpenEmbedded build system.
> - </para></listitem>
> <listitem><para><emphasis>Using a Development Shell:</emphasis>
> You can use a <filename>devshell</filename> to efficiently debug
> commands or simply edit packages.
> @@ -3189,47 +3183,6 @@
> </para>
> </section>
>
> -<section id='image-development-using-hob'>
> - <title>Image Development Using Hob</title>
> -
> - <para>
> - The <ulink url='&YOCTO_HOME_URL;/tools-resources/projects/hob'>Hob</ulink> is a graphical user interface for the
> - OpenEmbedded build system, which is based on BitBake.
> - You can use the Hob to build custom operating system images within the Yocto Project build environment.
> - Hob simply provides a friendly interface over the build system used during development.
> - In other words, building images with the Hob lets you take care of common build tasks more easily.
> - </para>
> -
> - <para>
> - For a better understanding of Hob, see the project page at
> - <ulink url='&YOCTO_HOME_URL;/tools-resources/projects/hob'></ulink>
> - on the Yocto Project website.
> - If you follow the "Documentation" link from the Hob page, you will
> - find a short introductory training video on Hob.
> - The following lists some features of Hob:
> - <itemizedlist>
> - <listitem><para>You can setup and run Hob using these commands:
> - <literallayout class='monospaced'>
> - $ source oe-init-build-env
> - $ hob
> - </literallayout></para></listitem>
> - <listitem><para>You can set the
> - <ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE'><filename>MACHINE</filename></ulink>
> - for which you are building the image.</para></listitem>
> - <listitem><para>You can modify various policy settings such as the
> - package format with which to build,
> - the parallelism BitBake uses, whether or not to build an
> - external toolchain, and which host to build against.
> - </para></listitem>
> - <listitem><para>You can manage
> - <link linkend='understanding-and-creating-layers'>layers</link>.</para></listitem>
> - <listitem><para>You can select a base image and then add extra packages for your custom build.
> - </para></listitem>
> - <listitem><para>You can launch and monitor the build from within Hob.</para></listitem>
> - </itemizedlist>
> - </para>
> -</section>
> -
> <section id="platdev-appdev-devshell">
> <title>Using a Development Shell</title>
>
> diff --git a/documentation/ref-manual/introduction.xml b/documentation/ref-manual/introduction.xml
> index 57e4a25..e82f834 100644
> --- a/documentation/ref-manual/introduction.xml
> +++ b/documentation/ref-manual/introduction.xml
> @@ -192,10 +192,6 @@
> supported Linux distribution, instances might exist where you
> encounter a problem while using the Yocto Project on a specific
> distribution.
> - For example, the CentOS 6.4 distribution does not include the
> - Gtk+ 2.20.0 and PyGtk 2.21.0 (or higher) packages, which are
> - required to run
> - <ulink url='&YOCTO_HOME_URL;/tools-resources/projects/hob'>Hob</ulink>.
> </note>
> </section>
>
> diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
> index 7f1ef8c..670e1c1 100644
> --- a/documentation/ref-manual/migration.xml
> +++ b/documentation/ref-manual/migration.xml
> @@ -125,7 +125,7 @@
> reference hardware Board Support Packages (BSPs), respectively:
> <filename>meta-yocto</filename> and
> <filename>meta-yocto-bsp</filename>.
> - When running BitBake or Hob for the first time after upgrading,
> + When running BitBake for the first time after upgrading,
> your <filename>conf/bblayers.conf</filename> file will be
> updated to handle this change and you will be asked to
> re-run or restart for the changes to take effect.
> @@ -1446,18 +1446,6 @@
> </section>
> </section>
>
> - <section id='migration-1.6-directory-layout-changes'>
> - <title>Directory Layout Changes</title>
> -
> - <para>
> - The <filename>meta-hob</filename> layer has been removed from
> - the top-level of the
> - <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>.
> - The contents of this layer are no longer needed by the Hob
> - user interface for building images and toolchains.
> - </para>
> - </section>
> -
> <section id='migration-1.6-package-test-ptest'>
> <title>Package Test (ptest)</title>
>
> diff --git a/documentation/ref-manual/ref-bitbake.xml b/documentation/ref-manual/ref-bitbake.xml
> index dc402db..90afe93 100644
> --- a/documentation/ref-manual/ref-bitbake.xml
> +++ b/documentation/ref-manual/ref-bitbake.xml
> @@ -414,7 +414,7 @@ Options:
> -l DEBUG_DOMAINS, --log-domains=DEBUG_DOMAINS
> Show debug logging for the specified logging domains
> -P, --profile Profile the command and save reports.
> - -u UI, --ui=UI The user interface to use (e.g. knotty, hob, depexp).
> + -u UI, --ui=UI The user interface to use (e.g. knotty, depexp).
> -t SERVERTYPE, --servertype=SERVERTYPE
> Choose which server to use, process or xmlrpc.
> --revisions-changed Set the exit code depending on whether upstream
> diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml
> index c4f15c9..bf4e5a9 100644
> --- a/documentation/ref-manual/ref-classes.xml
> +++ b/documentation/ref-manual/ref-classes.xml
> @@ -2558,22 +2558,6 @@
> </para>
> </section>
>
> -<section id='ref-classes-packageinfo'>
> - <title><filename>packageinfo.bbclass</filename></title>
> -
> - <para>
> - The <filename>packageinfo</filename> class
> - gives a BitBake user interface the ability to retrieve information
> - about output packages from the <filename>pkgdata</filename> files.
> - </para>
> -
> - <para>
> - This class is enabled automatically when using the
> - <ulink url='&YOCTO_HOME_URL;/tools-resources/projects/hob'>Hob</ulink>
> - user interface.
> - </para>
> -</section>
> -
> <section id='ref-classes-patch'>
> <title><filename>patch.bbclass</filename></title>
>
> diff --git a/documentation/ref-manual/ref-structure.xml b/documentation/ref-manual/ref-structure.xml
> index 725435e..578b381 100644
> --- a/documentation/ref-manual/ref-structure.xml
> +++ b/documentation/ref-manual/ref-structure.xml
> @@ -738,8 +738,7 @@
> <para>
> Be careful when deleting files in this directory.
> You can safely delete old images from this directory (e.g.
> - <filename>core-image-*</filename>, <filename>hob-image-*</filename>,
> - etc.).
> + <filename>core-image-*</filename>).
> However, the kernel (<filename>*zImage*</filename>, <filename>*uImage*</filename>, etc.),
> bootloader and other supplementary files might be deployed here prior to building an
> image.
> diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
> index 71f4ca6..fabce13 100644
> --- a/documentation/ref-manual/ref-variables.xml
> +++ b/documentation/ref-manual/ref-variables.xml
> @@ -1134,20 +1134,7 @@
> /home/scottrif/poky/meta-yocto-bsp \
> /home/scottrif/poky/meta-mykernel \
> "
> -
> - BBLAYERS_NON_REMOVABLE ?= " \
> - /home/scottrif/poky/meta \
> - /home/scottrif/poky/meta-yocto \
> - "
> </literallayout>
> - <note>
> - The
> - <link linkend='var-BBLAYERS_NON_REMOVABLE'><filename>BBLAYERS_NON_REMOVABLE</filename></link>
> - variable exists only for
> - <ulink url='https://www.yoctoproject.org/tools-resources/projects/hob'>Hob</ulink>.
> - The OpenEmbedded build system does not use this
> - variable.
> - </note>
> </para>
>
> <para>
> @@ -1157,47 +1144,6 @@
> </glossdef>
> </glossentry>
>
> - <glossentry id='var-BBLAYERS_NON_REMOVABLE'><glossterm>BBLAYERS_NON_REMOVABLE</glossterm>
> - <info>
> - BBLAYERS_NON_REMOVABLE[doc] = "Lists core layers that cannot be removed from the bblayers.conf file."
> - </info>
> - <glossdef>
> - <para role="glossdeffirst">
> -<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
> - Lists core layers that cannot be removed from the
> - <filename>bblayers.conf</filename> file during a build
> - using the
> - <ulink url='https://www.yoctoproject.org/tools-resources/projects/hob'>Hob</ulink>.
> - <note>
> - When building an image outside of Hob, the OpenEmbedded
> - build system ignores this variable.
> - </note>
> - </para>
> -
> - <para>
> - In order for BitBake to build your image using Hob, your
> - <filename>bblayers.conf</filename> file must include the
> - <filename>meta</filename> and <filename>meta-yocto</filename>
> - core layers.
> - Here is an example that shows these two layers listed in
> - the <filename>BBLAYERS_NON_REMOVABLE</filename> statement:
> - <literallayout class='monospaced'>
> - BBLAYERS = " \
> - /home/scottrif/poky/meta \
> - /home/scottrif/poky/meta-yocto \
> - /home/scottrif/poky/meta-yocto-bsp \
> - /home/scottrif/poky/meta-mykernel \
> - "
> -
> - BBLAYERS_NON_REMOVABLE ?= " \
> - /home/scottrif/poky/meta \
> - /home/scottrif/poky/meta-yocto \
> - "
> - </literallayout>
> - </para>
> - </glossdef>
> - </glossentry>
> -
> <glossentry id='var-BBMASK'><glossterm>BBMASK</glossterm>
> <info>
> BBMASK[doc] = "Prevents BitBake from processing specific recipes or recipe append files."
> diff --git a/documentation/toaster-manual/toaster-manual-intro.xml b/documentation/toaster-manual/toaster-manual-intro.xml
> index 278c33f..ee1dcba 100644
> --- a/documentation/toaster-manual/toaster-manual-intro.xml
> +++ b/documentation/toaster-manual/toaster-manual-intro.xml
> @@ -14,25 +14,6 @@
> remote build servers.
> </para>
>
> - <note>
> - <para>
> - This release of Toaster does allow you to configure and initiate
> - builds.
> - However, you cannot use Toaster to customize image recipes, which
> - still must either be done by hand or through
> - <ulink url='&YOCTO_HOME_URL;/tools-resources/projects/hob'>Hob</ulink>.
> - As Toaster matures, it eventually will equal and surpass Hob
> - functionality, at which time Hob will be deprecated.
> - </para>
> -
> - <para>
> - For more information on Hob,
> - see the
> - "<ulink url='&YOCTO_DOCS_DEV_URL;#image-development-using-hob'>Image Development Using Hob</ulink>"
> - section in the Yocto Project Development Manual.
> - </para>
> - </note>
> -
> <section id='intro-features'>
> <title>Toaster Features</title>
>
More information about the yocto
mailing list