summaryrefslogtreecommitdiffstats
path: root/bitbake/doc/user-manual/user-manual-metadata.xml
Commit message (Collapse)AuthorAgeFilesLines
* bitbake: user-manual-metadata.xml: Added varflag for vardepvalueexclude.Scott Rifenbark2014-03-251-0/+34
| | | | | | | | | | | | | Fixes [YOCTO #5897] Added several new varflags to the existing list in the "Variable Flags" section. The key one being the "vardepvalueexclude" flag. (Bitbake rev: 01a07dabb0d0c6a7f8c3c048396cfdf9d756b032) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Edits to "Basic Variable Setting"Scott Rifenbark2014-03-251-8/+1
| | | | | | | | | | | | | Fixes [YOCTO #5507] I applied some edits from Richard's review to the fix for handling variable setting. Moved the new section I created into the existing "Basic Variable Setting" section. (Bitbake rev: 0d63589abfa6b353f3b456a9a91de4dd98eb3965) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Sections to handle variable setting added.Scott Rifenbark2014-03-251-0/+20
| | | | | | | | | | | | | | | | Fixes [YOCTO #5507] I provided further explanation in the "Basic Variable Setting" section to note that trailing and leading blanks are not stripped from a value when set (e.g. VARIABLE = " value"). I added a new section "Null and Blank Setting" explaning that setting a variable to "" and " " are two different things. (Bitbake rev: 96d0b38577476a3576487f1fa9a4b6c9dff5d3ed) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual: Review edits applied throughout from Paul Eggleton.Scott Rifenbark2014-03-091-20/+20
| | | | | | | | | | | | | | Applied review edits from Paul Eggleton spanning the entire book. Small areas affected in all chapters except the "Hello World" Appendix. Noteworthy changes in the variables chapter where I added two new variables: BBINCLUDELOGS_LINES and BB_CONSOLELOG. (Bitbake rev: 2d4b09be70c6df0c1605f7e291149c682999cf50) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual: Review edits applied from Paul Eggleton.Scott Rifenbark2014-03-091-36/+51
| | | | | | | | | | Review of the entire manual by Paul. I have implemented his suggestions throughout. (Bitbake rev: 5cd310d1df194cd171691a4bcfb98024e2bc66b8) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Added BB_ORIGENV example.Scott Rifenbark2014-03-091-0/+9
| | | | | | | (Bitbake rev: d4328e2df355252870c3bf01031538a77795cedb) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Grammar fix.Scott Rifenbark2014-03-091-1/+1
| | | | | | | (Bitbake rev: 71e314b86957ecc01d77262d0a000f6f31db2bcc) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual: Review edits from Richard (second draft)Scott Rifenbark2014-03-091-2/+61
| | | | | | | | | | | | | Applied the comprehensive set of review comments from Richard Purdie. All files affected. One major point here was that the "BitBake Command" chapter was eliminated. This information was folded into various areas of the book. Consequently, the bits including the file for make had to be updated. (Bitbake rev: 8ec38c6b456a92a0e0b9b04c2793a5b148be5027) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Title change, sections lifted.Scott Rifenbark2014-03-091-200/+8
| | | | | | | | | | | | | | | | Changed the title of the chapter to "Syntax and Operators". It was called "Metadata". Removed the bulk the "Checksums (Signatures)" section and the placeholder for "Setscene". These are now in the "Execution" chapter. Created a more appropriate overview blurb to start the chapter. (Bitbake rev: f955171d8468ed987f92146d39f52d9af4a03dbb) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual: Added new chapter to cover BB execution.Scott Rifenbark2014-03-091-333/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | This commit added need files, cleaned up bogus links, and adjusted the build file, which is user-manual.xml. The new chapter file is "user-manual-execution.xml". The file has base text from the bitbake section from the "Closer Look" chapter of the YP ref-manual. This means that I had to initially include some figures from that book for now. I am not including them as part of this commit though as they will likely get renamed. I made sure that all links were removed that were specific to the YP ref-manual. Another change was in the user-manual.xml file to include the new chapter as part of the build. Another block of text for the new chapter was the "Running a Task" section from the user-manual-metadata.xml file. Consequently, that section was deleted from the "Metafile" chapter. Another block of text for the new chapter was the "Parsing and Execution" section from the user-manual-metadata.xml file. Consequently, that section was deleted from the "Metafile chapter. (Bitbake rev: f3b21d1fb711f9625d2ac92d4f4fe0f269242bd7) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: WIP - Some edits in the checksum area.Scott Rifenbark2014-03-091-23/+64
| | | | | | | (Bitbake rev: f74045d9ac88aece1d6f8d6a95389d01971ffdac) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Rewrite "Accessing Datastore Variables ↵Scott Rifenbark2014-03-091-65/+87
| | | | | | | | | | | | | | Using Python" Rewrote this section. Used a table instead of the funky list that was there. I still need to format it some. Also fixed up the term "datastore". It should not be "data store" (Bitbake rev: ee23839596102ccd58e028c10471438f2eb37feb) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Re-write the "Dependencies" section.Scott Rifenbark2014-03-091-41/+73
| | | | | | | | | General edits and dumping of the useless "Overview" section. (Bitbake rev: b11ad97b9334a86b2f3b10bdf5597910854475bd) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Re-write of "Variants - Class Extension ↵Scott Rifenbark2014-03-091-29/+40
| | | | | | | | | | | Mechanism" section. Some general rewrites here. (Bitbake rev: 7149ab6f6e936c19d681f05aa64b123c10f2f3da) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Re-write of "Events" section.Scott Rifenbark2014-03-091-33/+76
| | | | | | | | | General cleanup of the text. (Bitbake rev: 112dd4279826dc7587e1b8acb4a107374b5bd0fd) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: General cleanup to "Parsing and Execution"Scott Rifenbark2014-03-091-96/+164
| | | | | | | | | | | I went through and created links for variables we reference that are in the glossary. I also re-wrote much of the text to just clean it up. (Bitbake rev: dd9a4422d387da45f6de945eb4944c2a06bc98a0) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Edits to "Variable Flags" sectionScott Rifenbark2014-03-091-38/+115
| | | | | | | | | | | Worked through this section with Richard providing an interactive review. The changes are after the review. There was also a small edit to the "Tasks" section. (Bitbake rev: cba57f8d900d7c3ed8da9fcab0697e3047476325) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Rewrite of the "Tasks" section.Scott Rifenbark2014-03-091-66/+89
| | | | | | | | | | | | | | I cleaned up this section with some general improvements. I also broke this up into a couple sub-sections where it seemed to logically fall. Also, stole some metadata concept from the next section ("Running Tasks") that really should be lumped under "Tasks". (Bitbake rev: 9673acda2239807e31f4fcda1574b3e5e2d013a6) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Rewrite of the "Functions" section.Scott Rifenbark2014-03-091-59/+85
| | | | | | | | | | | Re-organized this around the 3 types of functions that we seem to be show-casing here. The original organization was not very good. (Bitbake rev: 77ef63e5c4a9ea633a1be0f9f90366e0ecf555fa) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Edits to "Sharing Functionality"Scott Rifenbark2014-03-091-29/+68
| | | | | | | | | Applied some review edits from Paul to the section. (Bitbake rev: f4dc71a3ff2c7f2ca6093b751883a1244f8d3847) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Add bare bones of a scheduler sectionRichard Purdie2014-03-091-0/+13
| | | | | | (Bitbake rev: cf0ccb26cc7af9f29704bb4c7ada6bf8ef5b0ee6) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Add details about general variables used ↵Richard Purdie2014-03-091-0/+19
| | | | | | | | by BitBake (Bitbake rev: 7e78785a53e259225b632c161a70d82fe66eb672) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Add details about environment variables ↵Richard Purdie2014-03-091-0/+13
| | | | | | | | used by BitBake (Bitbake rev: 91d3e60a48d2269adfd0084eb6f1bcdb211dbce1) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Edits to the "Sharing Functionality" section.Scott Rifenbark2014-02-111-28/+122
| | | | | | | | | Applied some review edits from Paul to the section. (Bitbake rev: 56321b18808f5ed932543d907b9ebcfbf4420233) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Edits to "Conditional Syntax (Overrides)"Scott Rifenbark2014-02-111-69/+138
| | | | | | | | | Re-wrote this section to use clearer more described examples. (Bitbake rev: 6eea23c4783c591c2d2c7f0b2a98e7a0cc8aa3c3) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Edits to "Defining Pure Python Functions"Scott Rifenbark2014-02-111-1/+4
| | | | | | | | | Made a review edit here to the section per Paul Eggleton. (Bitbake rev: 3b6ab095862367bc0101b995b002f62e7968ccf3) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Edits through syntax sectionScott Rifenbark2014-02-111-97/+183
| | | | | | | | | | | | | I made some general improvements in the "Overview" and "Basic Syntax" sections. Additionally, I added a blank section for "Variable Flags" that will eventually hold general information on this concept. Finally, come review edits to the "Defining Pure Python Functions" section per Paul Eggleton. (Bitbake rev: 665d655f436f1a353f5fe467c5d97588f7b121c5) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Added "Checksums (Signatures)" section.Scott Rifenbark2014-02-111-0/+183
| | | | | | | | | Added this section to the end of the Metadata chapter. (Bitbake rev: b653c58284cafd0b79991520543ca6239705d36b) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata.xml: Renamed section tagScott Rifenbark2014-01-271-1/+1
| | | | | | | | | | | | | There were two section tags that used the same id name "classes". One was in the intro chapter and one was in the metadata chapter. This was causing an exception in the PDF creation process and breaking it. I renamed the tag in the metadata chapter "metadata-classes". (Bitbake rev: d5f405586f7c50c602241519d32d02b1c7b1f345) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata: Clean up task documentationRichard Purdie2014-01-271-4/+24
| | | | | | (Bitbake rev: 55158ce6c5435544a62a60c0055724619bafde27) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata: Clean up task flag sectionRichard Purdie2014-01-271-10/+26
| | | | | | (Bitbake rev: b2e8c56d0f554e3b118f23b42858319110501180) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata: Expand parsing process docuemtnationRichard Purdie2014-01-271-1/+87
| | | | | | (Bitbake rev: 2596dd2b42c06ef258032356294cc345a6e25fed) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata: Add section about layersRichard Purdie2014-01-271-0/+40
| | | | | | (Bitbake rev: 0a99fe01dc273c548f7f83f9a7695c21184e7331) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata: Add section about INHERITRichard Purdie2014-01-271-0/+9
| | | | | | (Bitbake rev: f2ffe0365df7aa9c7d6c57b6bff8a5bbed198bfb) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata: Add section about running tasks and the ↵Richard Purdie2014-01-271-0/+74
| | | | | | | | environment (Bitbake rev: b32524643c125c78848630a5ce18d1df36313bc7) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata: Rework section about shell/python functionsRichard Purdie2014-01-271-12/+49
| | | | | | (Bitbake rev: c2bcb5364ff7c702bc1ec2726169f608b445f979) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata: Add section about data store operationsRichard Purdie2014-01-271-0/+69
| | | | | | (Bitbake rev: 85ffd05f292386de1b098debb6a3d3fe18c6b6b7) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata: Add lists of common eventsRichard Purdie2014-01-271-0/+27
| | | | | | (Bitbake rev: 240d3f0439e7c1f12e06fa738acc20fbcac8ae65) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata: Editing pass over the manual chapterRichard Purdie2014-01-271-105/+137
| | | | | | (Bitbake rev: 6f326f2f2785d6d48d7753abee6e8162852d8702) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata: Use filename tags instead of literal and ↵Richard Purdie2014-01-271-103/+110
| | | | | | | | varname tags (Bitbake rev: 56f8c4ad09c244522d68e203fe4cb76d593a9f2f) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata: Replace screen tags with literallayout tagsRichard Purdie2014-01-271-178/+142
| | | | | | (Bitbake rev: be3967f9f088e414c679e72a947817b60bab82d7) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata: Update whitespace (no content changes)Richard Purdie2014-01-271-247/+621
| | | | | | (Bitbake rev: 7eb1e340321ab4a5baa23e83eebf65ba13d23aef) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata: Reorder sections to more logical orderRichard Purdie2014-01-271-92/+95
| | | | | | (Bitbake rev: 6f2bed62bde5cd20f91c336b158f60f4a6bcb82f) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual-metadata: Add section ids for most sectionsRichard Purdie2014-01-271-33/+59
| | | | | | (Bitbake rev: 4ad94fb161d5fe24869696187e01004bff61d569) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
* bitbake: user-manual: Separate out chapters into individual filesRichard Purdie2014-01-271-0/+311
Splitting the manual into a chapter per file makes the content a little more managable. (Bitbake rev: 020178eba958d2d5142ee0909fc0fd133b97cd92) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>