BitBake/UserManual: Difference between revisions
From Yocto Project
Jump to navigationJump to search
| Line 31: | Line 31: | ||
* While BitBake fetcher supports numerous fetching protocols, only half of them are even used so I would simply ignore the unused ones. I made a bunch of notes on fetching [http://www.crashcourse.ca/wiki/index.php/BitBake_fetching_and_patching here]. | * While BitBake fetcher supports numerous fetching protocols, only half of them are even used so I would simply ignore the unused ones. I made a bunch of notes on fetching [http://www.crashcourse.ca/wiki/index.php/BitBake_fetching_and_patching here]. | ||
* Section 2.2.1 of current BitBake manual opens with discussion of "VAR_<override>_append" construct; that appears to be simply [http://lists.linuxtogo.org/pipermail/bitbake-devel/2013-January/003984.html broken and unused]. I would ignore it. The other form, "VAR_append_<override>" | * Section 2.2.1 of current BitBake manual opens with discussion of "VAR_<override>_append" construct; that appears to be simply [http://lists.linuxtogo.org/pipermail/bitbake-devel/2013-January/003984.html broken and unused]. I would ignore it. The other form, "VAR_append_<override>" is, of course, used massively and should be documented. | ||
== Deprecated/weird/dead stuff == | == Deprecated/weird/dead stuff == | ||
Revision as of 13:08, 2 January 2013
Introduction
The current BitBake User Manual, as of Dec. 31, 2012 is quite out dated. This page serves a a place to collect ideas for revisions that are required to the bring the User Manual up to date.
Current TOC
The chapter layout of the BitBake User Manual is currently:
- Introduction
- Metadata
- File Download Support
- The bitbake command
What to Include?
- As pointed out by rday, the patch function is inherent to oe-core, while the fetch function is inherent to bitbake. So can one be discussed without the other?
- Concepts:
- Explain each step in the bitbake process thoroughly.
- Provide context to commands. The why, not just the how.
Lessons to Include
- The Bitbaked Hello World
- Build on the work by Eren Turkey and the original tutorial at the OpenEmbedded wiki.
- Using the Bitbake Env Utility
Random observations by rday
- While BitBake fetcher supports numerous fetching protocols, only half of them are even used so I would simply ignore the unused ones. I made a bunch of notes on fetching here.
- Section 2.2.1 of current BitBake manual opens with discussion of "VAR_<override>_append" construct; that appears to be simply broken and unused. I would ignore it. The other form, "VAR_append_<override>" is, of course, used massively and should be documented.
Deprecated/weird/dead stuff
- All "proto=" should now be replaced with "protocol=", although the old form is still allowed but deprecated.
- All "pnum=" should now be replaced with "striplevel=" for patches.
- Current BitBake manual shows a "this=ignored" parm for patches; total mystery what that means, nothing uses it.
