sysmo-bts
/
generic-poky
9
0
Fork 0
Code Pull Requests Releases Activity

bitbake: bitbake-user-manual-hello.xml: Edits to the "Hello World" Appendix. 

Fixes [YOCTO #1973]

These are review changes applied from Paul Eggleton.

(Bitbake rev: 431181705f1bc3fc51439faa04a193debc1d03fd)

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 2014-04-17 11:57:51 -07:00 committed by Richard Purdie
parent 61a680fb5d
commit 57e8d56a6b
1 changed files with 17 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

46
bitbake/doc/bitbake-user-manual/bitbake-user-manual-hello.xml
View File

@ -14,7 +14,7 @@
example.
This appendix demonstrates, in tutorial form, Hello
World within the context of BitBake.
The tutorial describes how to create a new Project
The tutorial describes how to create a new project
and the applicable metadata files necessary to allow
BitBake to build it.
</para>
@ -95,26 +95,6 @@
You should now be able to enter the <filename>bitbake</filename>
command from the command line while working from any directory.
</para>
<para>
For a more permanent solution, assuming you are running the BASH
shell, edit <filename>~/.bashrc</filename> and add the following to the end
of that file:
<literallayout class='monospaced'>
PATH=&lt;path-to-bitbake-executable&gt;:$PATH
</literallayout>
</para>
<para>
If you're a Vim user, you will find useful
Vim configuration contributions in the
<filename>contrib/vim</filename> directory.
Copy the files from that directory to your
<filename>/home/yourusername/.vim</filename>
directory.
If that directory does not exist, create it, and then
restart Vim.
</para>
</section>
<section id='the-hello-world-example'>
@ -503,14 +483,22 @@ ERROR: Unable to parse base: ParseError in configuration INHERITs: Could not inh
BitBake finds the <filename>printhello</filename> recipe and
successfully runs the task.
<note>
Rerunning the task without removing the <filename>tmp</filename>
directory will not result in a BitBake run that prints the
same console output.
BitBake uses its Setscene process and determines that
nothing needs to be re-run.
If you delete the <filename>tmp</filename> directory and
then re-run the build, the printed output appears
at the console.
After the first execution, re-running
<filename>bitbake printhello</filename> again will not
result in a BitBake run that prints the same console
output.
The reason for this is that the first time the
<filename>printhello.bb</filename> recipe's
<filename>do_build</filename> task executes
successfully, BitBake writes a stamp file for the task.
Thus, the next time you attempt to run the task
using that same <filename>bitbake</filename> command,
BitBake notices the stamp and therefore determines
that the task does not need to be re-run.
If you delete the <filename>tmp</filename> directory
or run <filename>bitbake -c clean printhello</filename>
and then re-run the build, the "Hello, World!" message will
be printed again.
</note>
</para></listitem>
</orderedlist>