Browse Source

documentation: Purged "oe-init-build-env-memres" from docs

Fixes [YOCTO #11968]

Purged all occurrences of the "oe-init-build-env-memres" script
from the YP documentation set.  Occurrences in a lot of places.
The BBSERVER variable was also impacted and had to have the
definition updated.

(From yocto-docs rev: 274b05108d1bc53df20c11ab2efa15363bce23da)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Scott Rifenbark 7 years ago
parent
commit
b103ff6ba7

+ 4 - 14
documentation/bsp-guide/bsp.xml

@@ -99,11 +99,9 @@
                 <ulink url='&YOCTO_DOCS_REF_URL;#var-BBLAYERS'><filename>BBLAYERS</filename></ulink>
                 <ulink url='&YOCTO_DOCS_REF_URL;#var-BBLAYERS'><filename>BBLAYERS</filename></ulink>
                 variable in the <filename>conf/bblayers.conf</filename> file found in the
                 variable in the <filename>conf/bblayers.conf</filename> file found in the
                 <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>,
                 <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>,
-                which is established after you run one of the OpenEmbedded build environment
-                setup scripts (i.e.
-                <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink>
-                and
-                <ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink>).
+                which is established after you run the OpenEmbedded build environment
+                setup script (i.e.
+                <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink>).
                 Adding the root allows the OpenEmbedded build system to recognize the BSP
                 Adding the root allows the OpenEmbedded build system to recognize the BSP
                 definition and from it build an image.
                 definition and from it build an image.
                 Here is an example:
                 Here is an example:
@@ -282,13 +280,6 @@
                         <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink>.
                         <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink>.
                         After the script runs, your current working directory
                         After the script runs, your current working directory
                         is set to the <filename>build</filename> directory.
                         is set to the <filename>build</filename> directory.
-                        <note>
-                            For information on running a memory-resident
-                            <ulink url='&YOCTO_DOCS_REF_URL;#usingpoky-components-bitbake'>BitBake</ulink>,
-                            see the
-                            <ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink>
-                            setup script.
-                        </note>
                         </para></listitem>
                         </para></listitem>
                 </orderedlist>
                 </orderedlist>
             </para>
             </para>
@@ -1018,8 +1009,7 @@
                         your image.
                         your image.
                         You need to get the build environment ready by
                         You need to get the build environment ready by
                         sourcing an environment setup script
                         sourcing an environment setup script
-                        (i.e. <filename>oe-init-build-env</filename> or
-                        <filename>oe-init-build-env-memres</filename>)
+                        (i.e. <filename>oe-init-build-env</filename>)
                         and you need to be sure two key configuration
                         and you need to be sure two key configuration
                         files are configured appropriately: the
                         files are configured appropriately: the
                         <filename>conf/local.conf</filename> and the
                         <filename>conf/local.conf</filename> and the

+ 9 - 21
documentation/dev-manual/dev-manual-common-tasks.xml

@@ -1535,9 +1535,7 @@
                     <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>
                     <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>
                     and have sourced the build environment setup script
                     and have sourced the build environment setup script
                     (i.e.
                     (i.e.
-                    <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>oe-init-build-env</filename></ulink>
-                    or
-                    <ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink>).
+                    <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>oe-init-build-env</filename></ulink>).
                     Here is the basic <filename>recipetool</filename> syntax:
                     Here is the basic <filename>recipetool</filename> syntax:
                     <note>
                     <note>
                         Running <filename>recipetool -h</filename> or
                         Running <filename>recipetool -h</filename> or
@@ -1718,10 +1716,8 @@
             </para>
             </para>
 
 
             <para>
             <para>
-                Assuming you have sourced a build environment setup script (i.e.
-                <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink>
-                or
-                <ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink>)
+                Assuming you have sourced the build environment setup script (i.e.
+                <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink>)
                 and you are in the
                 and you are in the
                 <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>,
                 <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>,
                 use BitBake to process your recipe.
                 use BitBake to process your recipe.
@@ -4959,11 +4955,9 @@
                             </literallayout>
                             </literallayout>
                             </para></listitem>
                             </para></listitem>
                         <listitem><para>
                         <listitem><para>
-                            You must have sourced one of the build environment
-                            setup scripts (i.e.
-                            <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink>
-                            or
-                            <ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink>)
+                            You must have sourced the build environment
+                            setup script (i.e.
+                            <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink>)
                             found in the
                             found in the
                             <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>.
                             <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>.
                             </para></listitem>
                             </para></listitem>
@@ -5052,8 +5046,6 @@
                     artifacts ready and available.
                     artifacts ready and available.
                     Additionally, the environment must be set up using the
                     Additionally, the environment must be set up using the
                     <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink>
                     <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink>
-                    or
-                    <ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink>
                     script found in the
                     script found in the
                     <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>.
                     <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>.
                 </para>
                 </para>
@@ -6195,8 +6187,6 @@ Some notes from Cal:
                 environment, you must launch it using BitBake.
                 environment, you must launch it using BitBake.
                 Thus, the environment must be set up using the
                 Thus, the environment must be set up using the
                 <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink>
                 <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink>
-                or
-                <ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink>
                 script found in the
                 script found in the
                 <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>.
                 <ulink url='&YOCTO_DOCS_REF_URL;#build-directory'>Build Directory</ulink>.
                 You must also be sure of the state of your build in the
                 You must also be sure of the state of your build in the
@@ -7062,12 +7052,10 @@ Some notes from Cal:
             Aside from the <filename>*.sample</filename> configuration files,
             Aside from the <filename>*.sample</filename> configuration files,
             the <filename>conf-notes.txt</filename> also resides in the
             the <filename>conf-notes.txt</filename> also resides in the
             default <filename>meta-poky/conf</filename> directory.
             default <filename>meta-poky/conf</filename> directory.
-            The scripts that set up the build environment
+            The script that sets up the build environment
             (i.e.
             (i.e.
-            <ulink url="&YOCTO_DOCS_REF_URL;#structure-core-script"><filename>&OE_INIT_FILE;</filename></ulink>
-            and
-            <ulink url="&YOCTO_DOCS_REF_URL;#structure-memres-core-script"><filename>oe-init-build-env-memres</filename></ulink>)
-            use this file to display BitBake targets as part of the script
+            <ulink url="&YOCTO_DOCS_REF_URL;#structure-core-script"><filename>&OE_INIT_FILE;</filename></ulink>)
+            uses this file to display BitBake targets as part of the script
             output.
             output.
             Customizing this <filename>conf-notes.txt</filename> file is a
             Customizing this <filename>conf-notes.txt</filename> file is a
             good way to make sure your list of custom targets appears
             good way to make sure your list of custom targets appears

+ 1 - 3
documentation/dev-manual/dev-manual-qemu.xml

@@ -43,9 +43,7 @@
                             repository or you downloaded and unpacked a
                             repository or you downloaded and unpacked a
                             Yocto Project release tarball, you can source
                             Yocto Project release tarball, you can source
                             the build environment script (i.e.
                             the build environment script (i.e.
-                            <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink>
-                            or
-                            <ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink>):
+                            <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink>):
                             <literallayout class='monospaced'>
                             <literallayout class='monospaced'>
      $ cd ~/poky
      $ cd ~/poky
      $ source oe-init-build-env
      $ source oe-init-build-env

+ 2 - 4
documentation/dev-manual/dev-manual-start.xml

@@ -707,11 +707,9 @@
                 </para></listitem>
                 </para></listitem>
             <listitem><para>
             <listitem><para>
                 <emphasis>Initialize the Build Environment:</emphasis>
                 <emphasis>Initialize the Build Environment:</emphasis>
-                Initialize the build environment by sourcing a build
+                Initialize the build environment by sourcing the build
                 environment script (i.e.
                 environment script (i.e.
-                <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink>
-                or
-                <ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink>).
+                <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink>).
                 </para></listitem>
                 </para></listitem>
             <listitem><para>
             <listitem><para>
                 <emphasis>Make Sure Your <filename>local.conf</filename>
                 <emphasis>Make Sure Your <filename>local.conf</filename>

+ 1 - 3
documentation/kernel-dev/kernel-dev-common.xml

@@ -72,9 +72,7 @@
                         Before building an extensible SDK, you need to
                         Before building an extensible SDK, you need to
                         initialize the BitBake build environment by sourcing a
                         initialize the BitBake build environment by sourcing a
                         build environment script
                         build environment script
-                        (i.e. <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>oe-init-build-env</filename></ulink>
-                        or
-                        <ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink>):
+                        (i.e. <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>oe-init-build-env</filename></ulink>):
                         <literallayout class='monospaced'>
                         <literallayout class='monospaced'>
      $ cd ~/poky
      $ cd ~/poky
      $ source oe-init-build-env
      $ source oe-init-build-env

+ 1 - 3
documentation/ref-manual/faq.xml

@@ -699,9 +699,7 @@
                 When you use BitBake to build an image, all the build output
                 When you use BitBake to build an image, all the build output
                 goes into the directory created when you run the
                 goes into the directory created when you run the
                 build environment setup script (i.e.
                 build environment setup script (i.e.
-                <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>
-                or
-                <link linkend='structure-memres-core-script'><filename>oe-init-build-env-memres</filename></link>).
+                <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>).
                 By default, this
                 By default, this
                 <link linkend='build-directory'>Build Directory</link>
                 <link linkend='build-directory'>Build Directory</link>
                 is named <filename>build</filename> but can be named
                 is named <filename>build</filename> but can be named

+ 2 - 6
documentation/ref-manual/introduction.xml

@@ -546,9 +546,7 @@
                         On the machine that is able to run BitBake,
                         On the machine that is able to run BitBake,
                         be sure you have set up your build environment with
                         be sure you have set up your build environment with
                         the setup script
                         the setup script
-                        (<link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>
-                        or
-                        <link linkend='structure-memres-core-script'><filename>oe-init-build-env-memres</filename></link>).
+                        (<link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>).
                         </para></listitem>
                         </para></listitem>
                     <listitem><para>
                     <listitem><para>
                         Run the BitBake command to build the tarball:
                         Run the BitBake command to build the tarball:
@@ -711,9 +709,7 @@
                 system for builds.
                 system for builds.
                 The area is created when you <filename>source</filename> the
                 The area is created when you <filename>source</filename> the
                 setup environment script that is found in the Source Directory
                 setup environment script that is found in the Source Directory
-                (i.e. <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>
-                or
-                <link linkend='structure-memres-core-script'><filename>oe-init-build-env-memres</filename></link>).
+                (i.e. <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>).
                 The
                 The
                 <link linkend='var-TOPDIR'><filename>TOPDIR</filename></link>
                 <link linkend='var-TOPDIR'><filename>TOPDIR</filename></link>
                 variable points to the Build Directory.</para>
                 variable points to the Build Directory.</para>

+ 2 - 5
documentation/ref-manual/ref-development-environment.xml

@@ -1221,9 +1221,7 @@
             configuration files when you source the build environment
             configuration files when you source the build environment
             script
             script
             (i.e.
             (i.e.
-            <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>
-            or
-            <link linkend='structure-memres-core-script'><filename>oe-init-build-env-memres</filename></link>).
+            <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>).
         </para>
         </para>
 
 
         <para>
         <para>
@@ -1242,8 +1240,7 @@
         <para>
         <para>
             Because the Poky repository is fundamentally an aggregation of
             Because the Poky repository is fundamentally an aggregation of
             existing repositories, some users might be familiar with running
             existing repositories, some users might be familiar with running
-            the <filename>&OE_INIT_FILE;</filename> or
-            <filename>oe-init-build-env-memres</filename> script in the context
+            the <filename>&OE_INIT_FILE;</filename> script in the context
             of separate OpenEmbedded-Core and BitBake repositories rather than a
             of separate OpenEmbedded-Core and BitBake repositories rather than a
             single Poky repository.
             single Poky repository.
             This discussion assumes the script is executed from within a cloned
             This discussion assumes the script is executed from within a cloned

+ 11 - 183
documentation/ref-manual/ref-structure.xml

@@ -54,10 +54,8 @@
             When you run the <filename>bitbake</filename> command, the
             When you run the <filename>bitbake</filename> command, the
             main BitBake executable, which resides in the
             main BitBake executable, which resides in the
             <filename>bitbake/bin/</filename> directory, starts.
             <filename>bitbake/bin/</filename> directory, starts.
-            Sourcing an environment setup script (e.g.
-            <link linkend="structure-core-script"><filename>&OE_INIT_FILE;</filename></link>
-            or
-            <link linkend="structure-memres-core-script"><filename>oe-init-build-env-memres</filename></link>)
+            Sourcing the environment setup script (i.e.
+            <link linkend="structure-core-script"><filename>&OE_INIT_FILE;</filename></link>)
             places the <filename>scripts</filename> and
             places the <filename>scripts</filename> and
             <filename>bitbake/bin</filename> directories (in that order) into
             <filename>bitbake/bin</filename> directories (in that order) into
             the shell's <filename>PATH</filename> environment variable.
             the shell's <filename>PATH</filename> environment variable.
@@ -81,9 +79,7 @@
             is created initially when you <filename>source</filename>
             is created initially when you <filename>source</filename>
             the OpenEmbedded build environment setup script
             the OpenEmbedded build environment setup script
             (i.e.
             (i.e.
-            <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>
-            or
-            <link linkend='structure-memres-core-script'><filename>oe-init-build-env-memres</filename></link>).
+            <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>).
         </para>
         </para>
 
 
         <para>
         <para>
@@ -94,10 +90,8 @@
             the setup script.
             the setup script.
             For information on separating output from your local
             For information on separating output from your local
             Source Directory files, see the
             Source Directory files, see the
-            "<link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>
-            and
-            "<link linkend='structure-memres-core-script'><filename>oe-init-build-env-memres</filename></link>"
-            sections.
+            "<link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>"
+            section.
         </para>
         </para>
     </section>
     </section>
 
 
@@ -177,9 +171,7 @@
             This directory contains various integration scripts that implement
             This directory contains various integration scripts that implement
             extra functionality in the Yocto Project environment (e.g. QEMU scripts).
             extra functionality in the Yocto Project environment (e.g. QEMU scripts).
             The <link linkend="structure-core-script"><filename>&OE_INIT_FILE;</filename></link>
             The <link linkend="structure-core-script"><filename>&OE_INIT_FILE;</filename></link>
-            and
-            <link linkend='structure-memres-core-script'><filename>oe-init-build-env-memres</filename></link>
-            scripts append this directory to the shell's
+            script appends this directory to the shell's
             <filename>PATH</filename> environment variable.
             <filename>PATH</filename> environment variable.
         </para>
         </para>
 
 
@@ -194,14 +186,7 @@
         <title><filename>&OE_INIT_FILE;</filename></title>
         <title><filename>&OE_INIT_FILE;</filename></title>
 
 
         <para>
         <para>
-            This script is one of two scripts that set up the OpenEmbedded build
-            environment.
-            For information on the other script, see the
-            "<link linkend='structure-memres-core-script'><filename>oe-init-build-env-memres</filename></link>"
-            section.
-        </para>
-
-        <para>
+            This script sets up the OpenEmbedded build environment.
             Running this script with the <filename>source</filename> command in
             Running this script with the <filename>source</filename> command in
             a shell makes changes to <filename>PATH</filename> and sets other
             a shell makes changes to <filename>PATH</filename> and sets other
             core BitBake variables based on the current working directory.
             core BitBake variables based on the current working directory.
@@ -280,157 +265,6 @@
         </para>
         </para>
     </section>
     </section>
 
 
-    <section id='structure-memres-core-script'>
-        <title><filename>oe-init-build-env-memres</filename></title>
-
-        <para>
-            This script is one of two scripts that set up the OpenEmbedded
-            build environment.
-            Aside from setting up the environment, this script starts a
-            memory-resident BitBake server.
-            For information on the other setup script, see the
-            "<link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>"
-            section.
-        </para>
-
-        <para>
-            Memory-resident BitBake resides in memory until you specifically
-            remove it using the following BitBake command:
-            <literallayout class='monospaced'>
-     $ bitbake -m
-            </literallayout>
-        </para>
-
-        <para>
-            Running this script with the <filename>source</filename> command in
-            a shell makes changes to <filename>PATH</filename> and sets other
-            core BitBake variables based on the current working directory.
-            One of these variables is the
-            <link linkend='var-BBSERVER'><filename>BBSERVER</filename></link>
-            variable, which allows the OpenEmbedded build system to locate
-            the server that is running BitBake.
-        </para>
-
-        <para>
-            You need to run an environment setup script before using BitBake
-            commands.
-            Following is the script syntax:
-            <literallayout class='monospaced'>
-     $ source oe-init-build-env-memres <replaceable>port_number</replaceable> <replaceable>build_dir</replaceable>
-            </literallayout>
-            Following are some considerations when sourcing this script:
-            <itemizedlist>
-                <listitem><para>
-                    The script uses other scripts within the
-                    <filename>scripts</filename> directory to do the bulk of
-                    the work.
-                    </para></listitem>
-                <listitem><para>
-                    If you do not provide a port number with the script, the
-                    BitBake server starts at a randomly selected port.
-                    </para></listitem>
-                <listitem><para>
-                    The script's parameters are positionally dependent.
-                    Consequently, you cannot run the script and provide a
-                    <link linkend='build-directory'>Build Directory</link>
-                    name without also providing a port number.
-                    In other words, the following syntax is illegal:
-                    <literallayout class='monospaced'>
-     $ source oe-initbuild-env-memres <replaceable>build_dir</replaceable>
-                    </literallayout>
-                    <note>
-                        The previous restriction might be resolved in the
-                        future.
-                        See
-                        <ulink url='https://bugzilla.yoctoproject.org/show_bug.cgi?id=7555'>Bug 7555</ulink>
-                        for more information.
-                    </note>
-                    </para></listitem>
-            </itemizedlist>
-        </para>
-
-        <para>
-            When you run this script, your Yocto Project environment is set
-            up, a Build Directory is created, your working directory becomes
-            the Build Directory, and you are presented with a list of common
-            BitBake targets.
-            Here is an example:
-            <literallayout class='monospaced'>
-     $ source oe-init-build-env-memres
-     No port specified, using dynamically selected port
-
-     ### Shell environment set up for builds. ###
-
-     You can now run 'bitbake &lt;target&gt;'
-
-     Common targets are:
-         core-image-minimal
-         core-image-sato
-         meta-toolchain
-         meta-ide-support
-
-     You can also run generated qemu images with a command like 'runqemu qemux86'
-     Bitbake server address: 127.0.0.1, server port: 53995
-     Bitbake server started on demand as needed, use bitbake -m to shut it down
-            </literallayout>
-            The script gets its default list of common targets from the
-            <filename>conf-notes.txt</filename> file, which is found in the
-            <filename>meta-poky</filename> directory within the
-            <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>.
-            Should you have custom distributions, it is very easy to modify
-            this configuration file to include your targets for your
-            distribution.
-            See the
-            "<ulink url='&YOCTO_DOCS_DEV_URL;#creating-a-custom-template-configuration-directory'>Creating a Custom Template Configuration Directory</ulink>"
-            section in the Yocto Project Development Manual for more
-            information.
-        </para>
-
-        <para>
-            By default, running this script without a
-            <link linkend='build-directory'>Build Directory</link>
-            argument creates a build directory named
-            <filename>build</filename>.
-            If you provide a Build Directory argument and port number when you
-            <filename>source</filename> the script, the Build Directory is
-            created using that name.
-            For example, the following command starts the BitBake server using
-            port 53995 and creates a Build Directory named
-            <filename>mybuilds</filename> that is outside of the
-            <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>:
-            <literallayout class='monospaced'>
-     $ source oe-init-build-env-memres 53995 ~/mybuilds
-            </literallayout>
-            The <filename>oe-init-build-env-memres</filename> script starts a
-            memory resident BitBake server.
-            This BitBake instance uses the
-            <filename>bitbake-cookerdaemon.log</filename> file, which is
-            located in the Build Directory.
-        </para>
-
-        <para>
-            The OpenEmbedded build system uses the template configuration
-            files, which are found by default in the
-            <filename>meta-poky/conf</filename> directory in the
-            <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>.
-            See the
-            "<ulink url='&YOCTO_DOCS_DEV_URL;#creating-a-custom-template-configuration-directory'>Creating a Custom Template Configuration Directory</ulink>"
-            section in the Yocto Project Development Manual for more
-            information.
-            <note>
-                The OpenEmbedded build system does not support file or
-                directory names that contain spaces.
-                If you attempt to run the
-                <filename>oe-init-build-env-memres</filename> script
-                from a Source Directory that contains spaces in either the
-                filenames or directory names, the script returns an error
-                indicating no such file or directory.
-                Be sure to use a Source Directory free of names containing
-                spaces.
-            </note>
-        </para>
-    </section>
-
     <section id='structure-basic-top-level'>
     <section id='structure-basic-top-level'>
         <title><filename>LICENSE, README, and README.hardware</filename></title>
         <title><filename>LICENSE, README, and README.hardware</filename></title>
 
 
@@ -446,10 +280,8 @@
     <para>
     <para>
         The OpenEmbedded build system creates the
         The OpenEmbedded build system creates the
         <link linkend='build-directory'>Build Directory</link>
         <link linkend='build-directory'>Build Directory</link>
-        when you run one of the build environment setup scripts (i.e.
-        <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>
-        or
-        <link linkend='structure-memres-core-script'><filename>oe-init-build-env-memres</filename></link>).
+        when you run the build environment setup scripts (i.e.
+        <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>).
     </para>
     </para>
 
 
     <para>
     <para>
@@ -507,9 +339,7 @@
             <filename>local.conf.sample</filename> when
             <filename>local.conf.sample</filename> when
             you <filename>source</filename> the top-level build environment
             you <filename>source</filename> the top-level build environment
             setup script (i.e.
             setup script (i.e.
-            <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>
-            or
-            <link linkend='structure-memres-core-script'><filename>oe-init-build-env-memres</filename></link>).
+            <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>).
         </para>
         </para>
 
 
         <para>
         <para>
@@ -561,9 +391,7 @@
             <filename>bblayers.conf.sample</filename> when
             <filename>bblayers.conf.sample</filename> when
             you <filename>source</filename> the top-level build environment
             you <filename>source</filename> the top-level build environment
             setup script (i.e.
             setup script (i.e.
-            <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>
-            or
-            <link linkend='structure-memres-core-script'><filename>oe-init-build-env-memres</filename></link>).
+            <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>).
         </para>
         </para>
 
 
         <para>
         <para>

+ 25 - 31
documentation/ref-manual/ref-variables.xml

@@ -1299,29 +1299,29 @@
 
 
         <glossentry id='var-BBSERVER'><glossterm>BBSERVER</glossterm>
         <glossentry id='var-BBSERVER'><glossterm>BBSERVER</glossterm>
             <info>
             <info>
-                BBSERVER[doc] = "Points to the server that runs memory-resident BitBake."
+                BBSERVER[doc] = "Points to the BitBake remote server."
             </info>
             </info>
             <glossdef>
             <glossdef>
                 <para role="glossdeffirst">
                 <para role="glossdeffirst">
 <!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
 <!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
-                    Points to the server that runs memory-resident BitBake.
-                    This variable is set by the
-                    <link linkend='structure-memres-core-script'><filename>oe-init-build-env-memres</filename></link>
-                    setup script and should not be hand-edited.
-                    The variable is only used when you employ memory-resident
-                    BitBake.
-                    The setup script exports the value as follows:
+                    If defined in the BitBake environment,
+                    <filename>BBSERVER</filename> points to the BitBake
+                    remote server.
+                </para>
+
+                <para>
+                    Use the following format to export the variable to the
+                    BitBake environment:
                     <literallayout class='monospaced'>
                     <literallayout class='monospaced'>
-     export BBSERVER=localhost:$port
+     export BBSERVER=localhost:$port"
                     </literallayout>
                     </literallayout>
                 </para>
                 </para>
 
 
                 <para>
                 <para>
-                    For more information on how the
-                    <filename>BBSERVER</filename> is used, see the
-                    <filename>oe-init-build-env-memres</filename> script, which
-                    is located in the
-                    <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>.
+                    By default, <filename>BBSERVER</filename> also appears in
+                    <ulink url='&YOCTO_DOCS_BB_URL;#var-BB_HASHBASE_WHITELIST'><filename>BB_HASHBASE_WHITELIST</filename></ulink>.
+                    Consequently, <filename>BBSERVER</filename> is excluded
+                    from checksum and dependency data.
                 </para>
                 </para>
             </glossdef>
             </glossdef>
         </glossentry>
         </glossentry>
@@ -1736,11 +1736,9 @@
                     <link linkend='build-directory'>Build Directory</link>.
                     <link linkend='build-directory'>Build Directory</link>.
                     You can define this directory indirectly through the
                     You can define this directory indirectly through the
                     <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>
                     <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>
-                    and
-                    <link linkend='structure-memres-core-script'><filename>oe-init-build-env-memres</filename></link>
-                    scripts by passing in a Build Directory path when you run
-                    the scripts.
-                    If you run the scripts and do not provide a Build Directory
+                    script by passing in a Build Directory path when you run
+                    the script.
+                    If you run the script and do not provide a Build Directory
                     path, the <filename>BUILDDIR</filename> defaults to
                     path, the <filename>BUILDDIR</filename> defaults to
                     <filename>build</filename> in the current directory.
                     <filename>build</filename> in the current directory.
                 </para>
                 </para>
@@ -6626,7 +6624,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                         recipe in the
                         recipe in the
                         <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>
                         <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>
                         for an example initramfs recipe.
                         for an example initramfs recipe.
-                        To select this sample recipe as the one bulit
+                        To select this sample recipe as the one built
                         to provide the initramfs image,
                         to provide the initramfs image,
                         set <filename>INITRAMFS_IMAGE</filename> to
                         set <filename>INITRAMFS_IMAGE</filename> to
                         "core-image-minimal-initramfs".
                         "core-image-minimal-initramfs".
@@ -9026,19 +9024,17 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
 <!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
 <!--                <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
                     The directory from which the top-level build environment
                     The directory from which the top-level build environment
                     setup script is sourced.
                     setup script is sourced.
-                    The Yocto Project makes two top-level build environment
-                    setup scripts available:
-                    <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>
-                    and
-                    <link linkend='structure-memres-core-script'><filename>oe-init-build-env-memres</filename></link>.
-                    When you run one of these scripts, the
+                    The Yocto Project provides a top-level build environment
+                    setup script:
+                    <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>.
+                    When you run this script, the
                     <filename>OEROOT</filename> variable resolves to the
                     <filename>OEROOT</filename> variable resolves to the
                     directory that contains the script.
                     directory that contains the script.
                 </para>
                 </para>
 
 
                 <para>
                 <para>
                     For additional information on how this variable is used,
                     For additional information on how this variable is used,
-                    see the initialization scripts.
+                    see the initialization script.
                 </para>
                 </para>
             </glossdef>
             </glossdef>
         </glossentry>
         </glossentry>
@@ -15089,10 +15085,8 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                     The top-level
                     The top-level
                     <link linkend='build-directory'>Build Directory</link>.
                     <link linkend='build-directory'>Build Directory</link>.
                     BitBake automatically sets this variable when you
                     BitBake automatically sets this variable when you
-                    initialize your build environment using either
-                    <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>
-                    or
-                    <link linkend='structure-memres-core-script'><filename>oe-init-build-env-memres</filename></link>.
+                    initialize your build environment using
+                    <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>.
                 </para>
                 </para>
             </glossdef>
             </glossdef>
         </glossentry>
         </glossentry>

+ 2 - 4
documentation/ref-manual/usingpoky.xml

@@ -42,11 +42,9 @@
 
 
         <para>
         <para>
             The first thing you need to do is set up the OpenEmbedded build
             The first thing you need to do is set up the OpenEmbedded build
-            environment by sourcing an environment setup script
+            environment by sourcing the environment setup script
             (i.e.
             (i.e.
-            <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>
-            or
-            <link linkend='structure-memres-core-script'><filename>oe-init-build-env-memres</filename></link>).
+            <link linkend='structure-core-script'><filename>&OE_INIT_FILE;</filename></link>).
             Here is an example:
             Here is an example:
             <literallayout class='monospaced'>
             <literallayout class='monospaced'>
      $ source &OE_INIT_FILE; [<replaceable>build_dir</replaceable>]
      $ source &OE_INIT_FILE; [<replaceable>build_dir</replaceable>]

+ 1 - 3
documentation/sdk-manual/sdk-appendix-customizing.xml

@@ -148,9 +148,7 @@
             <listitem><para>
             <listitem><para>
                 If your OpenEmbedded build system setup uses a different
                 If your OpenEmbedded build system setup uses a different
                 environment setup script other than
                 environment setup script other than
-                <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink>
-                or
-                <ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink>,
+                <ulink url='&YOCTO_DOCS_REF_URL;#structure-core-script'><filename>&OE_INIT_FILE;</filename></ulink>,
                 then you must set
                 then you must set
                 <ulink url='&YOCTO_DOCS_REF_URL;#var-OE_INIT_ENV_SCRIPT'><filename>OE_INIT_ENV_SCRIPT</filename></ulink>
                 <ulink url='&YOCTO_DOCS_REF_URL;#var-OE_INIT_ENV_SCRIPT'><filename>OE_INIT_ENV_SCRIPT</filename></ulink>
                 to point to the environment setup script you use.
                 to point to the environment setup script you use.

+ 0 - 7
documentation/sdk-manual/sdk-appendix-obtain.xml

@@ -142,13 +142,6 @@
                 <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink>.
                 <ulink url='&YOCTO_DOCS_REF_URL;#source-directory'>Source Directory</ulink>.
                 After the script runs, your current working directory
                 After the script runs, your current working directory
                 is set to the <filename>build</filename> directory.
                 is set to the <filename>build</filename> directory.
-                <note>
-                    For information on running a memory-resident
-                    <ulink url='&YOCTO_DOCS_REF_URL;#usingpoky-components-bitbake'>BitBake</ulink>,
-                    see the
-                    <ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink>
-                    setup script.
-                </note>
                 </para></listitem>
                 </para></listitem>
             <listitem><para>
             <listitem><para>
                 <emphasis>Make Sure You Are Building an Installer for the Correct Machine:</emphasis>
                 <emphasis>Make Sure You Are Building an Installer for the Correct Machine:</emphasis>

+ 0 - 7
documentation/yocto-project-qs/yocto-project-qs.xml

@@ -602,13 +602,6 @@
                         is set to the Build Directory.
                         is set to the Build Directory.
                         Later, when the build completes, the Build Directory
                         Later, when the build completes, the Build Directory
                         contains all the files created during the build.
                         contains all the files created during the build.
-                        <note>
-                            For information on running a memory-resident
-                            <ulink url='&YOCTO_DOCS_REF_URL;#usingpoky-components-bitbake'>BitBake</ulink>,
-                            see the
-                            <ulink url='&YOCTO_DOCS_REF_URL;#structure-memres-core-script'><filename>oe-init-build-env-memres</filename></ulink>
-                            setup script.
-                        </note>
                         </para></listitem>
                         </para></listitem>
                     <listitem><para>
                     <listitem><para>
                         <emphasis>Examine Your Local Configuration File:</emphasis>
                         <emphasis>Examine Your Local Configuration File:</emphasis>