summaryrefslogtreecommitdiffstats
path: root/documentation/mega-manual
AgeCommit message (Collapse)Author
2020-10-06sphinx: remove DocBook filesNicolas Dechesne
The Yocto Project documentation was migrated to Sphinx. Let's remove the deprecated DocBook files. (From yocto-docs rev: 28fb0e63b2fbfd6426b00498bf2682bb53fdd862) Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2020-06-28mega-manual: Add SPDX license headersakuster
[Yocto #13873] (From yocto-docs rev: 0c975232996c11f0d6282879f361334c1fb82dd0) Signed-off-by: Armin Kuster <akuster808@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2020-04-06documentaiton: Change author infoakuster
Update the author indo and use variables for author and email to make it easier to change in future. (From yocto-docs rev: 4fdf2a060705fa00b11b5a9d270f4ffa506c9927) Signed-off-by: Armin Kuster <akuster808@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2020-04-06use defined entity "YOCTO_DOCS_URL", not "YOCTO_HOME_URL"rpjday@crashcourse.ca
Given the defined DocBook entity: <!ENTITY YOCTO_DOCS_URL "&YOCTO_HOME_URL;/docs"> replace numerous instances of the more verbose "&YOCTO_HOME_URL;/documentation", which is a redirect, anyway. rday (From yocto-docs rev: 53fa17321624028b12d880bc4236fbef46675eb4) Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2020-03-11manuals: Update YP manual notes with pointer to docs MLRobert P. J. Day
Update the "Manual Notes" section of numerous YP manuals with a reference to the recently-introduced YP documentation mailing list. (From yocto-docs rev: a10fe36c864b8f1a71c6a8eb7e1f6a4eef2f5171) Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2019-12-16YP 3.1 Docs: Updated Manual revision tables.Scott Rifenbark
Scrubbed so subsequent releases are relevant to the initial release only. (From yocto-docs rev: 7bb2c4f851aa968eb05b11c5471b81962f268eba) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2019-12-09YP Documentation: Set up for YP 3.1 releaseScott Rifenbark
* Updates to poky.ent * Updates to mega-manual.sed * Updates to all <manual>.xml files for date (From yocto-docs rev: 5f752ef0193cb60cd5d46a63e99ffcd02107e0c2) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2019-11-10mega-manual: Updated mega-manual Bitbake manual search pathScott Rifenbark
using ../.. instead of ../../.. Fixes [YOCTO #13553] (From yocto-docs rev: 6611a4726167e8597417e132661a29ec411266cc) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2019-10-23documenation: Changed "2.8" to "3.0".Scott Rifenbark
I was using "2.8" throughout the manual set instead of "3.0". Updated all aspects to "3.0". (From yocto-docs rev: db19937e98c59d4d2a9ce89877be3c8e0b05991a) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2019-06-18Makefile: Updated to support new NPM package creation sectionScott Rifenbark
The newly created section on how to create NPM packages required a figure. I added the figure to both the dev-manual and mega-manual tarballs creation areas. (From yocto-docs rev: 5109274d107b6d3ae6be3f71a20379cb6abb39d6) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2019-05-07documentation: Prepared for 2.8 releaseScott Rifenbark
poky.ent - variables all set up for 2.8 mega-manual.sed - "2.7" replaced with "2.8" <folder>.xml - manual revision history tables updated. (From yocto-docs rev: 6092a9282cbd397a2f64ca74361f862ea76b0e28) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2019-05-07mega-manual: Removed the Eclipse chaptersScott Rifenbark
Two chapters formerly in the sdk-manual were included when the mega-manual makes. These chapters are no longer needed. (From yocto-docs rev: a4e76a30baba5ab1d8f9783bb2a329d136600126) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2019-05-07mega-manual, overview-manual: Added updated index releases figureScott Rifenbark
The index-downloads.png file changes due to "eclipse" no longer being there. Both the overview-manual and the mega-manual figures folders hold this figure. (From yocto-docs rev: ef7b8dd8d636ef0ad563d1fe1ef44227f5f89fbc) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2019-05-07mega-manual: Removed two Eclipse figures from tarball listScott Rifenbark
Eclipse is no longer supported. We do not need thes figures as they would no longer exist. (From yocto-docs rev: efcfb5a62fcacdc606b8485da809bdf6aa19a5f3) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2019-02-25overview-manual, mega-manual: Updated Package Feeds diagramScott Rifenbark
The diagram had a typo in it ".ipd" rather than ".ipk". Fixed and dropped in the figures folder for each manual. (From yocto-docs rev: d39d196713a68df8d298f6ed0f40899bc148a323) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-12-27mega-manual: Updates to support BitBake User ManualScott Rifenbark
Fixes [YOCTO #12399] Fixes made to have the BitBake User Manual included in the build of the mega-manual. I placed this manual at the end of the mega-manual. Following changes made: * Makefile - Modified to include two PNG files. All PNG files in a given manual are listed in the area that makes the mega-manual so that the tarfile is complete. * mega-manual.xml - Updated the front wording to tell the user that the BitBake User Manual is included in the Mega-Manual. Also, added a last section to actually include the bitbake-title.png file and the *.xml files. Note that I could not add the title figure from the same figures folder of the local "bitbake" folder. Would not include in the build. So, I pulled the file from the figures folder of the mega-manual, which is what I do for all the other book titles used in the mega-manual. * mega-manual.sed - Modified to clean out the old stuff that had been carried along for older books not supported for the release. Modified to include link processing for the newly included BitBake User Manual. * New Figures - Moved copies of the "bb_multiconfig_files.png" and "bitbake-title.png" figures into the figures folder of the mega-manual. (From yocto-docs rev: 78a1ae0ca92bb7f8a9d3a32a320299371d0ed361) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-12-15documentation: Preparing for 2.7 release.Scott Rifenbark
Updated poky.ent to have variables for 2.7. Updated mega-manual.sed file to use "2.7" string. Updated all <manual>.xml Manual History Tables to use "TBD" (From yocto-docs rev: d6f8bbd6e107913265ea1ac95ab8817e199ff60b) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-08-28dev-manual, Makefile: Created new section on multi-config build depsScott Rifenbark
Rewrote the section on setting up and executing multi-config builds. Broke the section into two sub-sections. One is for the standard information that was there for setting up a multi-config build. A new section was for the cross-build dependencies in multi-config builds. Part of the re-write included creating a new figure that shows the configuration file hierarchy needed for these types of builds. So, new figure added to both the dev-manual and the mega-manual figures directories. Finally, the Makefile needed updated to account for the new figures. (From yocto-docs rev: dc158e97c216aa6e7fa3755164409d581f8569c5) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-08-15sdk-manual, mega-manual: Updated the fig for installed ext. SDKScott Rifenbark
This figure had changed. I updated the file and folder hierarchy. Also fixed some wording. (From yocto-docs rev: 359292397781f9f5eac2fb693d89ec286ddf9940) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-08-15sdk-manual, mega-manual: Updated standard SDK install directory figureScott Rifenbark
The figure was incorrect for the installed file and folder hierarchy for a standard SDK. I updated it. This figure goes in both the sdk-manual and the mega-manual. (From yocto-docs rev: a0dc11ce74bba0a18f385d9800f93524340ed033) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-06-15sdk-manual: Created a new Makefile flow diagramScott Rifenbark
The Makefile-Based Projects section was expanded to add a useful example and figure. Added this figure to the sdk-manual and mega-manual figures folders. Updated the Makefile to include the new figure as part of the tar files for each manual. (From yocto-docs rev: 6261cb55b6393e0d5dce91cdb7c8e6e83849ec0c) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-06-15sdk-manual: Review edits to the "Autotools-Based Projects" section.Scott Rifenbark
Autotools is simpler now as it uses "autoreconf" to one-step a bunch of the existing tools such as aclocal and autoconf. I updated the figure to reflect the simpler flow and also the steps that accompany the figure. (From yocto-docs rev: 380cb1bb89003229befb4715e875586c798d6735) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-06-15sdk-manual, mega-manual: Added Autotools flow figureScott Rifenbark
New figure for the section on Autotools workflow. The figure goes in the folders for both the sdk-manual and the mega-manual. Updated the Makefile to include the new figure in the tarball when creating both manuals. (From yocto-docs rev: ccb2c4b9ebd0b0aaa55b5790eb6a916701e10af4) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-06-15sdk-manual, mega-manual: Updated devtool add and upgrade figuresScott Rifenbark
Took out the $TMPDIR part for the output and left more generically as "Build Output". (From yocto-docs rev: 4b0375e3293d67e4b5be433cd6c468532fee5a30) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-06-15sdk-manual, mega-manual: Updated the devtool upgrade flow diagram.Scott Rifenbark
Added more detail at the top for how the local recipe interacts with the Upstream Source. (From yocto-docs rev: c1d49a7c00c458b55396c0efc7a329acd870be6c) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-06-15sdk-manual, mega-manual: Updated devtool add flow diagramScott Rifenbark
Added more detail on how the upstream source or files from srctree are located. (From yocto-docs rev: 5eff4b1b68c232071814969b6367188352639f17) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24sdk-manual: Updated devtool add workflow section.Scott Rifenbark
Had to update the figure to use "Upstream Source" labels and fix a wrong "devtool edit-recipe" command. That new figure went into both figures folders for the sdk-manual and mega-manual areas. Provideds some cleaner wording. (From yocto-docs rev: 6225d04dd0551a840d929b752225064a222962bc) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24documentation: Set up the 2.6 version of the docsScott Rifenbark
poky.ent - Edited for new variables. <manual>.xml - Manual revision tables updated mega-manual.sed - swapped out 2.5 for 2.6 (From yocto-docs rev: 2bae8fa18ae82a325785276acdeb1394e110d2cf) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24dev-manual: Removed "newbie" chapter.Scott Rifenbark
This chapter only had the stuff about submitting a defect against YP and making a change to YP. I moved that information into the common tasks chapter as it is "how-to" information. Removal of this chapter alse required that the mega-manual.xml file be updated to not include the chapter. (From yocto-docs rev: 4421b1585c21a6f7862525ba972f7e765626066e) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24documentation: Removed release date ENTITYScott Rifenbark
Now that 2.5 has released, I replaced the ENTITY variable used for the moving month and year with the actual release month and year (i.e. May 2018). (From yocto-docs rev: 2d6e8ddce4fce0c405d2aea69cea2a5b262410f7) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24overview-manual, mega-manual: Updated the sdk figureScott Rifenbark
Added the manifest files to the figure and the associated variables. Also added the test files. (From yocto-docs rev: cfba55462d1c37ef2ff6454890da64a40f9c3607) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24overview-manual, mega-manual: Updated the Images figureScott Rifenbark
I needed to add some italic formatting for variable type strings. (From yocto-docs rev: afc6d2d10081f9e9d940075c03b3e704b37cf13b) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24overview-manual, mega-manual: Updated image generation imageScott Rifenbark
The figure for image generation of the BitBake process needed some enhancing. (From yocto-docs rev: fc978663a7962d1515d4f47abe8ae522b9e24ce1) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24overview-manual, mega-manual: Updated SDK generation imageScott Rifenbark
The image needed a little bit of clean up. (From yocto-docs rev: d4fb680be194b7f9b192e06f0081a09504649633) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24overview-manual, mega-manual: Updated package splitting figureScott Rifenbark
More changes to the "analysis-for-package-splitting.png" figure. I needed to work in "do_populate_sysroot" task and several STAGING_DIR_* variables. (From yocto-docs rev: fcb88024a7dfff1b6cca49770f67bf4c1f548362) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24overview-manual, mega-manual: Updated the config/compile figureScott Rifenbark
The figure had the wrong hierarchy for the "image", "recipe-sysroot", and "recipe-sysroot-native" folders. Moved out a level. (From yocto-docs rev: e1f45b666b1cd589cee9c9ae6dba01467b991ef9) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24overview-manual, mega-manual: Updated the package splitting figure.Scott Rifenbark
Figure was out of date. (From yocto-docs rev: 5b56862ec39fc05299cd6d468f13f75b74c3b800) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24overview-manual, mega-manual: Updated Config and Compile figureScott Rifenbark
The "configuration-compile-autoreconfig.png" figure was badly out of date. It was not showing the two sysroot directories and did not use the $BPN variable. I have updated the figure and placed in both the overview-manual/figures area and the mega-manual/figures area. (From yocto-docs rev: dba3b2b65f18870229dcb3dbcb8fadc099165894) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24sdk-manual, mega-manual: Updated devtool modify workflow diagramScott Rifenbark
Added detail for the step one. Clearer. (From yocto-docs rev: ef95d547180ce53fade7a3764f8d362422472c7a) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24overview-manual: Updated the "patching.png" figureScott Rifenbark
The figure had a bad "PN" variable being used in the "S" directory. This needed to be changed to "BPN". (From yocto-docs rev: beafc55eb3646ecb96929e44538de952207f0b76) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24overview-manual, mega-manual: Updated source-fetching.png figureScott Rifenbark
The figure was incorrect. Replaced the PN variable with BPN for the "S" directory. (From yocto-docs rev: 440edcdae932a83b6c32b51e85d97178a77b4bed) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24mega-manual: Updated the package-feeds.png fileScott Rifenbark
This image was out of date. (From yocto-docs rev: 061f2766217a6a3914c14e7bfcf09e2c03f73165) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24documentation: Added ENTITY variable to track a release date and yearScott Rifenbark
(From yocto-docs rev: 65a87312f541e2f2b01fa1918f7a12da607fe7ab) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24overview-manual, mega-manual: Updated figuresScott Rifenbark
Updated the layer-input.png and source-input.png figures. Had to trim them so they were tighter in the figure. Also, updated some context in the source-input.png figures. (From yocto-docs rev: cad644af48b0a1cb2baeb8d2649b9aa7ccbdeda5) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24overview-manual, mega-manual: Updates to layers discussion for build flowScott Rifenbark
The "Metadata, Machine Configuratrion, and Policy Configuration" section discusses the three types of layers fed into the OpenEmbedded build system workflow figure. I updated the figures and text supporting this discussion. The figure had to be moved to the mega-manual/figures folder also. (From yocto-docs rev: 39dd671333f7b3df616920aab08e01c926deca1c) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24overview-manual, mega-manual: Updated user-configuration.png imageScott Rifenbark
This image was out of date. I updated it. (From yocto-docs rev: feb287a72201363c43607508d2e8f1da3993f93f) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24overview-manual, mega-manual: Removed bitbake workflow figureScott Rifenbark
This version of the figure was not as cool looking as the other version, which is preferred. I have removed it. (From yocto-docs rev: ed0346b00ee6b47d90efedd1dd69e4a92a42afe9) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24overview-manual: Updated title .PNG fileScott Rifenbark
The file was stretching beyond the rendered display window such that part of the Yocto Logo was missing. Also had to place the updated .PNG file in the mega-manual/figures folder. (From yocto-docs rev: 5b73c54fcb2c3f60aee2ff7dc19c4aad102aa505) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24poky.ent: Added YOCTO_DOCS_OM_URL entityScott Rifenbark
The variabe for the "getting-started" manual goes away and is replaced by this one for the new "overview-manual." (From yocto-docs rev: 45fc9beac6db4c40c3660fc9e54cc11e9c1f96c4) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2018-05-24mega-manual: removed chapters from concepts manualScott Rifenbark
these chapters were sucked into the getting-started manual but now are no longer even needed there. The chapters are organizational for the old concepts-manual and provide nothing for the getting-started. (From yocto-docs rev: dd97d06039e3fd6bcbbccafa99f4d29ce041ae70) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>