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