mega-manual.xml 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376
  1. <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
  2. "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
  3. [<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] >
  4. <book id='mega-manual' lang='en'
  5. xmlns:xi="http://www.w3.org/2003/XInclude"
  6. xmlns="http://docbook.org/ns/docbook"
  7. >
  8. <bookinfo>
  9. <abstract>
  10. The Yocto Project Mega-Manual is a concatenation of the published
  11. Yocto Project HTML manuals along with the corresponding BitBake
  12. User Manual for the given release.
  13. The Mega-Manual exists to help users efficiently search for strings
  14. across the entire Yocto Project documentation set inclusive of
  15. the BitBake User Manual.
  16. </abstract>
  17. <mediaobject>
  18. <imageobject>
  19. <imagedata fileref='figures/mega-title.png'
  20. format='SVG'
  21. align='left' scalefit='1' width='100%'/>
  22. </imageobject>
  23. </mediaobject>
  24. <title>
  25. Yocto Project Mega-Manual
  26. </title>
  27. <authorgroup>
  28. <author>
  29. <firstname>Scott</firstname> <surname>Rifenbark</surname>
  30. <affiliation>
  31. <orgname>Scotty's Documentation Services, INC</orgname>
  32. </affiliation>
  33. <email>srifenbark@gmail.com</email>
  34. </author>
  35. </authorgroup>
  36. <revhistory>
  37. <revision>
  38. <revnumber>1.8</revnumber>
  39. <date>April 2015</date>
  40. <revremark>Released with the Yocto Project 1.8 Release.</revremark>
  41. </revision>
  42. <revision>
  43. <revnumber>2.0</revnumber>
  44. <date>October 2015</date>
  45. <revremark>Released with the Yocto Project 2.0 Release.</revremark>
  46. </revision>
  47. <revision>
  48. <revnumber>2.1</revnumber>
  49. <date>April 2016</date>
  50. <revremark>Released with the Yocto Project 2.1 Release.</revremark>
  51. </revision>
  52. <revision>
  53. <revnumber>2.2</revnumber>
  54. <date>October 2016</date>
  55. <revremark>Released with the Yocto Project 2.2 Release.</revremark>
  56. </revision>
  57. <revision>
  58. <revnumber>2.3</revnumber>
  59. <date>May 2017</date>
  60. <revremark>Released with the Yocto Project 2.3 Release.</revremark>
  61. </revision>
  62. <revision>
  63. <revnumber>2.4</revnumber>
  64. <date>October 2017</date>
  65. <revremark>Released with the Yocto Project 2.4 Release.</revremark>
  66. </revision>
  67. <revision>
  68. <revnumber>2.5</revnumber>
  69. <date>May 2018</date>
  70. <revremark>Released with the Yocto Project 2.5 Release.</revremark>
  71. </revision>
  72. <revision>
  73. <revnumber>2.6</revnumber>
  74. <date>November 2018</date>
  75. <revremark>Released with the Yocto Project 2.6 Release.</revremark>
  76. </revision>
  77. <revision>
  78. <revnumber>2.7</revnumber>
  79. <date>May 2019</date>
  80. <revremark>Released with the Yocto Project 2.7 Release.</revremark>
  81. </revision>
  82. <revision>
  83. <revnumber>3.0</revnumber>
  84. <date>October 2019</date>
  85. <revremark>Released with the Yocto Project 3.0 Release.</revremark>
  86. </revision>
  87. <revision>
  88. <revnumber>3.0.1</revnumber>
  89. <date>December 2019</date>
  90. <revremark>Released with the Yocto Project 3.0.1 Release.</revremark>
  91. </revision>
  92. <revision>
  93. <revnumber>3.0.2</revnumber>
  94. <date>FEBURARY 2020;</date>
  95. <revremark>Released with the Yocto Project 3.0.2 Release.</revremark>
  96. </revision>
  97. <revision>
  98. <revnumber>3.0.3</revnumber>
  99. <date>May 2020;</date>
  100. <revremark>Released with the Yocto Project 3.0.3 Release.</revremark>
  101. </revision>
  102. <revision>
  103. <revnumber>3.0.4</revnumber>
  104. <date>&REL_MONTH_YEAR;</date>
  105. <revremark>Released with the Yocto Project 3.0.4 Release.</revremark>
  106. </revision>
  107. </revhistory>
  108. <copyright>
  109. <year>&COPYRIGHT_YEAR;</year>
  110. <holder>Linux Foundation</holder>
  111. </copyright>
  112. <legalnotice>
  113. <para>
  114. Permission is granted to copy, distribute and/or modify this document under
  115. the terms of the <ulink type="http" url="http://creativecommons.org/licenses/by-sa/2.0/uk/">Creative Commons Attribution-Share Alike 2.0 UK: England &amp; Wales</ulink> as published by Creative Commons.
  116. </para>
  117. <note><title>Manual Notes</title>
  118. <itemizedlist>
  119. <listitem><para>
  120. This version of the
  121. <emphasis>Yocto Project Mega-Manual</emphasis>
  122. is for the &YOCTO_DOC_VERSION; release of the
  123. Yocto Project.
  124. To be sure you have the latest version of the manual
  125. for this release, go to the
  126. <ulink url='&YOCTO_HOME_URL;/documentation'>Yocto Project documentation page</ulink>
  127. and select the manual from that site.
  128. Manuals from the site are more up-to-date than manuals
  129. derived from the Yocto Project released TAR files.
  130. </para></listitem>
  131. <listitem><para>
  132. If you located this manual through a web search, the
  133. version of the manual might not be the one you want
  134. (e.g. the search might have returned a manual much
  135. older than the Yocto Project version with which you
  136. are working).
  137. You can see all Yocto Project major releases by
  138. visiting the
  139. <ulink url='&YOCTO_WIKI_URL;/wiki/Releases'>Releases</ulink>
  140. page.
  141. If you need a version of this manual for a different
  142. Yocto Project release, visit the
  143. <ulink url='&YOCTO_HOME_URL;/documentation'>Yocto Project documentation page</ulink>
  144. and select the manual set by using the
  145. "ACTIVE RELEASES DOCUMENTATION" or "DOCUMENTS ARCHIVE"
  146. pull-down menus.
  147. </para></listitem>
  148. <listitem><para>
  149. To report any inaccuracies or problems with this
  150. manual, send an email to the Yocto Project
  151. discussion group at
  152. <filename>yocto@yoctoproject.com</filename> or log into
  153. the freenode <filename>#yocto</filename> channel.
  154. </para></listitem>
  155. </itemizedlist>
  156. </note>
  157. </legalnotice>
  158. </bookinfo>
  159. <!-- Includes brief-yoctoprojectqs -->
  160. <para>
  161. <imagedata fileref="figures/bypqs-title.png" width="100%" align="left" scalefit="1" />
  162. </para>
  163. <xi:include
  164. xmlns:xi="http://www.w3.org/2003/XInclude" href="../brief-yoctoprojectqs/brief-yoctoprojectqs.xml"/>
  165. <!-- Includes overview-manual title image and then overview-manual chapters -->
  166. <para>
  167. <imagedata fileref="figures/overview-manual-title.png" width="100%" align="left" scalefit="1" />
  168. </para>
  169. <xi:include
  170. xmlns:xi="http://www.w3.org/2003/XInclude" href="../overview-manual/overview-manual-intro.xml"/>
  171. <xi:include
  172. xmlns:xi="http://www.w3.org/2003/XInclude" href="../overview-manual/overview-manual-yp-intro.xml"/>
  173. <xi:include
  174. xmlns:xi="http://www.w3.org/2003/XInclude" href="../overview-manual/overview-manual-development-environment.xml"/>
  175. <xi:include
  176. xmlns:xi="http://www.w3.org/2003/XInclude" href="../overview-manual/overview-manual-concepts.xml"/>
  177. <!-- Includes dev-manual title image and then dev-manual chapters -->
  178. <para>
  179. <imagedata fileref="figures/dev-title.png" width="100%" align="left" scalefit="1" />
  180. </para>
  181. <xi:include
  182. xmlns:xi="http://www.w3.org/2003/XInclude" href="../dev-manual/dev-manual-intro.xml"/>
  183. <xi:include
  184. xmlns:xi="http://www.w3.org/2003/XInclude" href="../dev-manual/dev-manual-start.xml"/>
  185. <xi:include
  186. xmlns:xi="http://www.w3.org/2003/XInclude" href="../dev-manual/dev-manual-common-tasks.xml"/>
  187. <xi:include
  188. xmlns:xi="http://www.w3.org/2003/XInclude" href="../dev-manual/dev-manual-qemu.xml"/>
  189. <!-- Includes sdk-manual title image and then sdk-manual chapters -->
  190. <para>
  191. <imagedata fileref="figures/sdk-title.png" width="100%" align="left" scalefit="1" />
  192. </para>
  193. <xi:include
  194. xmlns:xi="http://www.w3.org/2003/XInclude" href="../sdk-manual/sdk-intro.xml"/>
  195. <xi:include
  196. xmlns:xi="http://www.w3.org/2003/XInclude" href="../sdk-manual/sdk-extensible.xml"/>
  197. <xi:include
  198. xmlns:xi="http://www.w3.org/2003/XInclude" href="../sdk-manual/sdk-using.xml"/>
  199. <xi:include
  200. xmlns:xi="http://www.w3.org/2003/XInclude" href="../sdk-manual/sdk-working-projects.xml"/>
  201. <xi:include
  202. xmlns:xi="http://www.w3.org/2003/XInclude" href="../sdk-manual/sdk-appendix-obtain.xml"/>
  203. <xi:include
  204. xmlns:xi="http://www.w3.org/2003/XInclude" href="../sdk-manual/sdk-appendix-customizing.xml"/>
  205. <xi:include
  206. xmlns:xi="http://www.w3.org/2003/XInclude" href="../sdk-manual/sdk-appendix-customizing-standard.xml"/>
  207. <!-- Includes bsp-guide title image and then bsp-guide chapters -->
  208. <para>
  209. <imagedata fileref="figures/bsp-title.png" width="100%" align="left" scalefit="1" />
  210. </para>
  211. <xi:include
  212. xmlns:xi="http://www.w3.org/2003/XInclude" href="../bsp-guide/bsp.xml"/>
  213. <!-- Includes kernel-dev title image and then kernel-dev chapters -->
  214. <para>
  215. <imagedata fileref="figures/kernel-dev-title.png" width="100%" align="left" scalefit="1" />
  216. </para>
  217. <xi:include
  218. xmlns:xi="http://www.w3.org/2003/XInclude" href="../kernel-dev/kernel-dev-intro.xml"/>
  219. <xi:include
  220. xmlns:xi="http://www.w3.org/2003/XInclude" href="../kernel-dev/kernel-dev-common.xml"/>
  221. <xi:include
  222. xmlns:xi="http://www.w3.org/2003/XInclude" href="../kernel-dev/kernel-dev-advanced.xml"/>
  223. <xi:include
  224. xmlns:xi="http://www.w3.org/2003/XInclude" href="../kernel-dev/kernel-dev-concepts-appx.xml"/>
  225. <xi:include
  226. xmlns:xi="http://www.w3.org/2003/XInclude" href="../kernel-dev/kernel-dev-maint-appx.xml"/>
  227. <!-- Includes profile-manual title image and then profile-manual chapters -->
  228. <para>
  229. <imagedata fileref="figures/profile-title.png" width="100%" align="left" scalefit="1" />
  230. </para>
  231. <xi:include
  232. xmlns:xi="http://www.w3.org/2003/XInclude" href="../profile-manual/profile-manual-intro.xml"/>
  233. <xi:include
  234. xmlns:xi="http://www.w3.org/2003/XInclude" href="../profile-manual/profile-manual-arch.xml"/>
  235. <xi:include
  236. xmlns:xi="http://www.w3.org/2003/XInclude" href="../profile-manual/profile-manual-usage.xml"/>
  237. <xi:include
  238. xmlns:xi="http://www.w3.org/2003/XInclude" href="../profile-manual/profile-manual-examples.xml"/>
  239. <!-- Includes ref-manual title image and then ref-manual chapters -->
  240. <para>
  241. <imagedata fileref="figures/poky-title.png" width="100%" align="left" scalefit="1" />
  242. </para>
  243. <xi:include
  244. xmlns:xi="http://www.w3.org/2003/XInclude" href="../ref-manual/ref-system-requirements.xml"/>
  245. <xi:include
  246. xmlns:xi="http://www.w3.org/2003/XInclude" href="../ref-manual/ref-terms.xml"/>
  247. <xi:include
  248. xmlns:xi="http://www.w3.org/2003/XInclude" href="../ref-manual/ref-release-process.xml"/>
  249. <xi:include
  250. xmlns:xi="http://www.w3.org/2003/XInclude" href="../ref-manual/migration.xml"/>
  251. <xi:include
  252. xmlns:xi="http://www.w3.org/2003/XInclude" href="../ref-manual/ref-structure.xml"/>
  253. <xi:include
  254. xmlns:xi="http://www.w3.org/2003/XInclude" href="../ref-manual/ref-classes.xml"/>
  255. <xi:include
  256. xmlns:xi="http://www.w3.org/2003/XInclude" href="../ref-manual/ref-tasks.xml"/>
  257. <xi:include
  258. xmlns:xi="http://www.w3.org/2003/XInclude" href="../ref-manual/ref-devtool-reference.xml"/>
  259. <xi:include
  260. xmlns:xi="http://www.w3.org/2003/XInclude" href="../ref-manual/ref-kickstart.xml"/>
  261. <xi:include
  262. xmlns:xi="http://www.w3.org/2003/XInclude" href="../ref-manual/ref-qa-checks.xml"/>
  263. <xi:include
  264. xmlns:xi="http://www.w3.org/2003/XInclude" href="../ref-manual/ref-images.xml"/>
  265. <xi:include
  266. xmlns:xi="http://www.w3.org/2003/XInclude" href="../ref-manual/ref-features.xml"/>
  267. <xi:include
  268. xmlns:xi="http://www.w3.org/2003/XInclude" href="../ref-manual/ref-variables.xml"/>
  269. <xi:include
  270. xmlns:xi="http://www.w3.org/2003/XInclude" href="../ref-manual/ref-varlocality.xml"/>
  271. <xi:include
  272. xmlns:xi="http://www.w3.org/2003/XInclude" href="../ref-manual/faq.xml"/>
  273. <xi:include
  274. xmlns:xi="http://www.w3.org/2003/XInclude" href="../ref-manual/resources.xml"/>
  275. <!-- Includes toaster-manual title image and then toaster-manual chapters -->
  276. <para>
  277. <imagedata fileref="figures/toaster-title.png" width="100%" align="left" scalefit="1" />
  278. </para>
  279. <xi:include
  280. xmlns:xi="http://www.w3.org/2003/XInclude" href="../toaster-manual/toaster-manual-intro.xml"/>
  281. <xi:include
  282. xmlns:xi="http://www.w3.org/2003/XInclude" href="../toaster-manual/toaster-manual-start.xml"/>
  283. <xi:include
  284. xmlns:xi="http://www.w3.org/2003/XInclude" href="../toaster-manual/toaster-manual-setup-and-use.xml"/>
  285. <xi:include
  286. xmlns:xi="http://www.w3.org/2003/XInclude" href="../toaster-manual/toaster-manual-reference.xml"/>
  287. <!-- Includes bitbake-user-manual title image and then bitbake-user-manual chapters -->
  288. <para>
  289. <imagedata fileref="figures/bitbake-title.png" width="100%" align="left" scalefit="1" />
  290. </para>
  291. <xi:include
  292. xmlns:xi="http://www.w3.org/2003/XInclude" href="../../bitbake/doc/bitbake-user-manual/bitbake-user-manual-intro.xml"/>
  293. <xi:include
  294. xmlns:xi="http://www.w3.org/2003/XInclude" href="../../bitbake/doc/bitbake-user-manual/bitbake-user-manual-execution.xml"/>
  295. <xi:include
  296. xmlns:xi="http://www.w3.org/2003/XInclude" href="../../bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml"/>
  297. <xi:include
  298. xmlns:xi="http://www.w3.org/2003/XInclude" href="../../bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml"/>
  299. <xi:include
  300. xmlns:xi="http://www.w3.org/2003/XInclude" href="../../bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml"/>
  301. <xi:include
  302. xmlns:xi="http://www.w3.org/2003/XInclude" href="../../bitbake/doc/bitbake-user-manual/bitbake-user-manual-hello.xml"/>
  303. </book>
  304. <!--
  305. vim: expandtab tw=80 ts=4
  306. -->