From de1dcde413d2b07ea9b3a8e7b5409f2a94f63847 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Tue, 27 Sep 2011 13:07:06 -0700 Subject: [PATCH] documentation/poky-ref-manual: Updates to several variables. I did complete rewrites of RDEPENDS, RRECOMMENDS, MACHINE_ESSENTIAL_EXTRA_RDEPENDS, MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS, MACHINE_EXTRA_RDEPENDS, and MACHINE_EXTRA_RRECOMMENDS. These are sent out for review but these changes represent the first attempt to clear up confusion on how the six variables are used and relate to each other. (From yocto-docs rev: 1d93707fb9383d51322e96eb521e96fcac8bcc47) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- .../poky-ref-manual/ref-variables.xml | 129 ++++++++++++++++-- .../poky-ref-manual/ref-varlocality.xml | 6 +- 2 files changed, 124 insertions(+), 11 deletions(-) diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml index 9089ccb65c..3e176f1963 100644 --- a/documentation/poky-ref-manual/ref-variables.xml +++ b/documentation/poky-ref-manual/ref-variables.xml @@ -663,29 +663,142 @@ - MACHINE_ESSENTIAL_RDEPENDS + MACHINE_ESSENTIAL_EXTRA_RDEPENDS - Specifies the list of packages required to boot the device. + + A list of packages that must be installed as part of the package being + built in order for the + resulting image to boot on the system. + The machine depends on these items - without them it will not boot. + If a package in this list cannot be found during the build, the build + will not complete. + Some examples of these machine essentials are flash, screen, keyboard, mouse, + or touchscreen drivers (depending on the machine). + + + For example, suppose you are building a runtime package that depends + on a mouse driver. + In this case, you would use the following + MACHINE_ESSENTIAL_EXTRA_RDEPENDS + statement: + + MACHINE_ESSENTIAL_EXTRA_RDEPENDS += "<mouse_driver>" + + - MACHINE_ESSENTIAL_RRECOMMENDS + MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS - Specifies the list of packages required to boot the device (usually - additional kernel modules). + + A list of packages that must be installed as part of the package being + built in order for the + resulting image to boot on the system. + The machine depends on these items - without them it will not boot. + If a package in this list cannot be found during the build, the build + will not complete. + + + This variable is similar to the + MACHINE_ESSENTIAL_EXTRA_RDEPENDS + with the exception that the package being built does not have a build + dependency on the variable's list of packages. + + + Someone help me out here... How can this list be "recommended" yet part + of the machine essential list? + Seems to me that anything that is machine essential pretty much needs to + be there. + The rest of this section needs an appropriate example. + + + Some examples of these machine essentials are flash, screen, keyboard, mouse, + or touchscreen drivers (depending on the machine). + + + For example, suppose you are building a runtime package that depends + on a mouse driver. + In this case, you would use the following + MACHINE_ESSENTIAL_EXTRA_RDEPENDS + statement: + + MACHINE_ESSENTIAL_EXTRA_RDEPENDS += "<mouse_driver>" + + MACHINE_EXTRA_RDEPENDS - Specifies the list of packages required to use the devices + + A list of packages that should be installed as part of the package + being built in order for the + resulting image to boot on the system and achieve full functionality. + Although the machine does not need these items in order to boot, if you want the + extra functionality they provide the package being built depends on them + being there. + If a package in this list cannot be found during the build, the build + will not complete. + + + I need a real-world example here.... + + + An example of a machine extra is a WiFi driver. + The machine may or may not have a WiFi card. + If it does, the package with the driver needs to be present for the card to work. + However, if the machine does not have a WiFi card, the machine will still boot. + + + For example, suppose you are building a runtime package that depends + on a WiFi driver. + In this case, you would use the following + MACHINE_EXTRA_RDEPENDS + statement: + + MACHINE_EXTRA_RDEPENDS += "<wifi_driver>" + + MACHINE_EXTRA_RRECOMMENDS - Specifies the list of packages useful to use the device (e.g. - additional kernel modules) + + A list of packages that should be installed as part of the package + being built in order for the + machine to boot and achieve full functionality. + Although the machine does not need these items in order to boot, if you want the + extra functionality they provide the package being built should include + them. + + + This variable is similar to the + MACHINE_EXTRA_RDEPENDS + with the exception that the package being built does not have a build + dependency on the variable's list of packages. + If a package in this list cannot be found during the build, the build + will still continue. + + + I need a real-world example to use here please.... + + + An example of a machine extra is a WiFi driver. + The machine may or may not have a WiFi card. + If it does, the package with the driver needs to be present for the card to work. + However, if the machine does not have a WiFi card, the machine will still boot. + + + For example, suppose you are building a runtime package that depends + on a WiFi driver. + In this case, you would use the following + MACHINE_EXTRA_RDEPENDS + statement: + + MACHINE_EXTRA_RDEPENDS += "<wifi_driver>" + + diff --git a/documentation/poky-ref-manual/ref-varlocality.xml b/documentation/poky-ref-manual/ref-varlocality.xml index d3d931b4d0..0a2477c123 100644 --- a/documentation/poky-ref-manual/ref-varlocality.xml +++ b/documentation/poky-ref-manual/ref-varlocality.xml @@ -71,10 +71,10 @@ MACHINE_EXTRA_RRECOMMENDS - MACHINE_ESSENTIAL_RDEPENDS + MACHINE_ESSENTIAL_EXTRA_RDEPENDS - - MACHINE_ESSENTIAL_RRECOMMENDS + + MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS