aboutsummaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2012-07-13 13:51:13 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2012-07-17 10:54:09 +0100
commit738d9479fa465668c7b9814ac308ccc52b03b493 (patch)
tree8bc442f7ea6a56007cdec0cace434e923a9cf94a /documentation
parentc6c2ebacb9fc1a70610246189dd77a775b2c1317 (diff)
downloadopenembedded-core-contrib-738d9479fa465668c7b9814ac308ccc52b03b493.tar.gz
documentation/poky-ref-manual/development.xml: Removed devshell section
Removed the "Development Using a Development Shell" section. This section was moved to the YP Development manual into the "Common Development Models" chapter. (From yocto-docs rev: 4222ce12d620bf3cd98ae80b19402cf59cca3d3f) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r--documentation/poky-ref-manual/development.xml78
1 files changed, 0 insertions, 78 deletions
diff --git a/documentation/poky-ref-manual/development.xml b/documentation/poky-ref-manual/development.xml
index f7e67a6545..af8a59cb0c 100644
--- a/documentation/poky-ref-manual/development.xml
+++ b/documentation/poky-ref-manual/development.xml
@@ -15,84 +15,6 @@
This chapter describes each development method.
</para>
- <section id="platdev-appdev-devshell">
- <title>Development Within a Development Shell</title>
-
- <para>
- When debugging certain commands or even when just editing packages,
- <filename>devshell</filename> can be a useful tool.
- Using <filename>devshell</filename> differs from the example shown in the previous
- section in that when you invoke <filename>devshell</filename> source files are
- extracted into your working directory and patches are applied.
- Then, a new terminal is opened and you are placed in the working directory.
- In the new terminal, all the OpenEmbedded build-related environment variables are
- still defined so you can use commands such as <filename>configure</filename> and
- <filename>make</filename>.
- The commands execute just as if the OpenEmbedded build system were executing them.
- Consequently, working this way can be helpful when debugging a build or preparing
- software to be used with the OpenEmbedded build system.
- </para>
-
- <para>
- Following is an example that uses <filename>devshell</filename> on a target named
- <filename>matchbox-desktop</filename>:
- </para>
-
- <para>
- <literallayout class='monospaced'>
- $ bitbake matchbox-desktop -c devshell
- </literallayout>
- </para>
-
- <para>
- This command opens a terminal with a shell prompt within the OpenEmbedded build environment.
- The following occurs:
- <itemizedlist>
- <listitem><para>The <filename>PATH</filename> variable includes the
- cross-toolchain.</para></listitem>
- <listitem><para>The <filename>pkgconfig</filename> variables find the correct
- <filename>.pc</filename> files.</para></listitem>
- <listitem><para>The <filename>configure</filename> command finds the
- Yocto Project site files as well as any other necessary files.</para></listitem>
- </itemizedlist>
- Within this environment, you can run <filename>configure</filename>
- or <filename>compile</filename> commands as if they were being run by
- the OpenEmbedded build system itself.
- As noted earlier, the working directory also automatically changes to the
- source directory (<filename><link linkend='var-S'>S</link></filename>).
- </para>
-
- <para>
- When you are finished, you just exit the shell or close the terminal window.
- </para>
-
- <para>
- The default shell used by <filename>devshell</filename> is xterm.
- For examples of available options, see the "UI/Interaction Configuration"
- section of the
- <filename>meta/conf/bitbake.conf</filename> configuration file in the
- <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>source directory</ulink>.
- </para>
-
- <para>
- Because an external shell is launched rather than opening directly into the
- original terminal window, it allows easier interaction with BitBake's multiple
- threads as well as accomodates a future client/server split.
- </para>
-
- <note>
- <para>It is worth remembering that when using <filename>devshell</filename>
- you need to use the full compiler name such as <filename>arm-poky-linux-gnueabi-gcc</filename>
- instead of just using <filename>gcc</filename>.
- The same applies to other applications such as <filename>binutils</filename>,
- <filename>libtool</filename> and so forth.
- BitBake sets up environment variables such as <filename>CC</filename>
- to assist applications, such as <filename>make</filename> to find the correct tools.</para>
- <para>It is also worth noting that <filename>devshell</filename> still works over
- X11 forwarding and similar situations</para>
- </note>
- </section>
-
<section id="platdev-appdev-srcrev">
<title>Development Within Yocto Project for a Package that Uses an External SCM</title>