diff options
Diffstat (limited to 'documentation/ref-manual/ref-variables.xml')
-rw-r--r-- | documentation/ref-manual/ref-variables.xml | 132 |
1 files changed, 68 insertions, 64 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index aadae01ac4..1aabd5c71d 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml | |||
@@ -136,7 +136,7 @@ | |||
136 | <note> | 136 | <note> |
137 | If <filename>ALTERNATIVE_LINK_NAME</filename> is not | 137 | If <filename>ALTERNATIVE_LINK_NAME</filename> is not |
138 | defined, it defaults to | 138 | defined, it defaults to |
139 | <filename>${bindir}/<name></filename>. | 139 | <filename>${bindir}/<replaceable>name</replaceable></filename>. |
140 | </note> | 140 | </note> |
141 | </para> | 141 | </para> |
142 | 142 | ||
@@ -159,9 +159,9 @@ | |||
159 | a default for specific commands tied to particular packages. | 159 | a default for specific commands tied to particular packages. |
160 | Here are the available syntax forms: | 160 | Here are the available syntax forms: |
161 | <literallayout class='monospaced'> | 161 | <literallayout class='monospaced'> |
162 | ALTERNATIVE_PRIORITY = "<priority>" | 162 | ALTERNATIVE_PRIORITY = "<replaceable>priority</replaceable>" |
163 | ALTERNATIVE_PRIORITY[<name>] = "<priority>" | 163 | ALTERNATIVE_PRIORITY[<replaceable>name</replaceable>] = "<replaceable>priority</replaceable>" |
164 | ALTERNATIVE_PRIORITY_<pkg>[<name>] = "<priority>" | 164 | ALTERNATIVE_PRIORITY_<replaceable>pkg</replaceable>[<replaceable>name</replaceable>] = "<replaceable>priority</replaceable>" |
165 | </literallayout> | 165 | </literallayout> |
166 | </para> | 166 | </para> |
167 | 167 | ||
@@ -185,9 +185,9 @@ | |||
185 | a default for specific commands tied to particular packages. | 185 | a default for specific commands tied to particular packages. |
186 | Here are the available syntax forms: | 186 | Here are the available syntax forms: |
187 | <literallayout class='monospaced'> | 187 | <literallayout class='monospaced'> |
188 | ALTERNATIVE_TARGET = "<target>" | 188 | ALTERNATIVE_TARGET = "<replaceable>target</replaceable>" |
189 | ALTERNATIVE_TARGET[<name>] = "<target>" | 189 | ALTERNATIVE_TARGET[<replaceable>name</replaceable>] = "<replaceable>target</replaceable>" |
190 | ALTERNATIVE_TARGET_<pkg>[<name>] = "<target>" | 190 | ALTERNATIVE_TARGET_<replaceable>pkg</replaceable>[<replaceable>name</replaceable>] = "<replaceable>target</replaceable>" |
191 | </literallayout> | 191 | </literallayout> |
192 | <note> | 192 | <note> |
193 | <para> | 193 | <para> |
@@ -338,13 +338,13 @@ | |||
338 | being installed by listing them with the | 338 | being installed by listing them with the |
339 | <filename>BAD_RECOMMENDATIONS</filename> variable: | 339 | <filename>BAD_RECOMMENDATIONS</filename> variable: |
340 | <literallayout class='monospaced'> | 340 | <literallayout class='monospaced'> |
341 | BAD_RECOMMENDATIONS = "<package_name> <package_name> <package_name> ..." | 341 | BAD_RECOMMENDATIONS = "<replaceable>package_name</replaceable> <replaceable>package_name</replaceable> <replaceable>package_name</replaceable> ..." |
342 | </literallayout> | 342 | </literallayout> |
343 | You can set this variable globally in your | 343 | You can set this variable globally in your |
344 | <filename>local.conf</filename> file or you can attach it to | 344 | <filename>local.conf</filename> file or you can attach it to |
345 | a specific image recipe by using the recipe name override: | 345 | a specific image recipe by using the recipe name override: |
346 | <literallayout class='monospaced'> | 346 | <literallayout class='monospaced'> |
347 | BAD_RECOMMENDATIONS_pn-<target_image> = "<package_name>" | 347 | BAD_RECOMMENDATIONS_pn-<replaceable>target_image</replaceable> = "<replaceable>package_name</replaceable>" |
348 | </literallayout> | 348 | </literallayout> |
349 | </para> | 349 | </para> |
350 | 350 | ||
@@ -445,11 +445,11 @@ | |||
445 | <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>. | 445 | <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>. |
446 | Use the following form: | 446 | Use the following form: |
447 | <literallayout class='monospaced'> | 447 | <literallayout class='monospaced'> |
448 | BB_DISKMON_DIRS = "<action>,<dir>,<threshold> [...]" | 448 | BB_DISKMON_DIRS = "<replaceable>action</replaceable>,<replaceable>dir</replaceable>,<replaceable>threshold</replaceable> [...]" |
449 | 449 | ||
450 | where: | 450 | where: |
451 | 451 | ||
452 | <action> is: | 452 | <replaceable>action</replaceable> is: |
453 | ABORT: Immediately abort the build when | 453 | ABORT: Immediately abort the build when |
454 | a threshold is broken. | 454 | a threshold is broken. |
455 | STOPTASKS: Stop the build after the currently | 455 | STOPTASKS: Stop the build after the currently |
@@ -463,14 +463,14 @@ | |||
463 | which must be defined in the | 463 | which must be defined in the |
464 | conf/local.conf file. | 464 | conf/local.conf file. |
465 | 465 | ||
466 | <dir> is: | 466 | <replaceable>dir</replaceable> is: |
467 | Any directory you choose. You can specify one or | 467 | Any directory you choose. You can specify one or |
468 | more directories to monitor by separating the | 468 | more directories to monitor by separating the |
469 | groupings with a space. If two directories are | 469 | groupings with a space. If two directories are |
470 | on the same device, only the first directory | 470 | on the same device, only the first directory |
471 | is monitored. | 471 | is monitored. |
472 | 472 | ||
473 | <threshold> is: | 473 | <replaceable>threshold</replaceable> is: |
474 | Either the minimum available disk space, | 474 | Either the minimum available disk space, |
475 | the minimum number of free inodes, or | 475 | the minimum number of free inodes, or |
476 | both. You must specify at least one. To | 476 | both. You must specify at least one. To |
@@ -559,16 +559,16 @@ | |||
559 | When specifying the variable in your configuration file, | 559 | When specifying the variable in your configuration file, |
560 | use the following form: | 560 | use the following form: |
561 | <literallayout class='monospaced'> | 561 | <literallayout class='monospaced'> |
562 | BB_DISKMON_WARNINTERVAL = "<disk_space_interval>,<disk_inode_interval>" | 562 | BB_DISKMON_WARNINTERVAL = "<replaceable>disk_space_interval</replaceable>,<replaceable>disk_inode_interval</replaceable>" |
563 | 563 | ||
564 | where: | 564 | where: |
565 | 565 | ||
566 | <disk_space_interval> is: | 566 | <replaceable>disk_space_interval</replaceable> is: |
567 | An interval of memory expressed in either | 567 | An interval of memory expressed in either |
568 | G, M, or K for Gbytes, Mbytes, or Kbytes, | 568 | G, M, or K for Gbytes, Mbytes, or Kbytes, |
569 | respectively. You cannot use GB, MB, or KB. | 569 | respectively. You cannot use GB, MB, or KB. |
570 | 570 | ||
571 | <disk_inode_interval> is: | 571 | <replaceable>disk_inode_interval</replaceable> is: |
572 | An interval of free inodes expressed in either | 572 | An interval of free inodes expressed in either |
573 | G, M, or K for Gbytes, Mbytes, or Kbytes, | 573 | G, M, or K for Gbytes, Mbytes, or Kbytes, |
574 | respectively. You cannot use GB, MB, or KB. | 574 | respectively. You cannot use GB, MB, or KB. |
@@ -643,7 +643,7 @@ | |||
643 | which is a compiler built to run on the build machine but produces binaries | 643 | which is a compiler built to run on the build machine but produces binaries |
644 | that run on the target <link linkend='var-MACHINE'><filename>MACHINE</filename></link>; | 644 | that run on the target <link linkend='var-MACHINE'><filename>MACHINE</filename></link>; |
645 | "nativesdk", which targets the SDK machine instead of <filename>MACHINE</filename>; | 645 | "nativesdk", which targets the SDK machine instead of <filename>MACHINE</filename>; |
646 | and "mulitlibs" in the form "<filename>multilib:<multilib_name></filename>". | 646 | and "mulitlibs" in the form "<filename>multilib:</filename><replaceable>multilib_name</replaceable>". |
647 | </para> | 647 | </para> |
648 | 648 | ||
649 | <para> | 649 | <para> |
@@ -651,7 +651,7 @@ | |||
651 | is as simple as adding the following to your recipe: | 651 | is as simple as adding the following to your recipe: |
652 | <literallayout class='monospaced'> | 652 | <literallayout class='monospaced'> |
653 | BBCLASSEXTEND =+ "native nativesdk" | 653 | BBCLASSEXTEND =+ "native nativesdk" |
654 | BBCLASSEXTEND =+ "multilib:<multilib_name>" | 654 | BBCLASSEXTEND =+ "multilib:<replaceable>multilib_name</replaceable>" |
655 | </literallayout> | 655 | </literallayout> |
656 | </para> | 656 | </para> |
657 | </glossdef> | 657 | </glossdef> |
@@ -856,9 +856,9 @@ | |||
856 | Set the variable as you would any environment variable | 856 | Set the variable as you would any environment variable |
857 | and then run BitBake: | 857 | and then run BitBake: |
858 | <literallayout class='monospaced'> | 858 | <literallayout class='monospaced'> |
859 | $ BBPATH = "<build_directory>" | 859 | $ BBPATH = "<replaceable>build_directory</replaceable>" |
860 | $ export BBPATH | 860 | $ export BBPATH |
861 | $ bitbake <target> | 861 | $ bitbake <replaceable>target</replaceable> |
862 | </literallayout> | 862 | </literallayout> |
863 | </note> | 863 | </note> |
864 | </para> | 864 | </para> |
@@ -2241,7 +2241,7 @@ | |||
2241 | you want the error reporting tool to store the debug files | 2241 | you want the error reporting tool to store the debug files |
2242 | as follows in your <filename>local.conf</filename> file: | 2242 | as follows in your <filename>local.conf</filename> file: |
2243 | <literallayout class='monospaced'> | 2243 | <literallayout class='monospaced'> |
2244 | ERR_REPORT_DIR = "path" | 2244 | ERR_REPORT_DIR = "<replaceable>path</replaceable>" |
2245 | </literallayout> | 2245 | </literallayout> |
2246 | </para> | 2246 | </para> |
2247 | </glossdef> | 2247 | </glossdef> |
@@ -2585,11 +2585,11 @@ | |||
2585 | should have the name of the feature item as an override. | 2585 | should have the name of the feature item as an override. |
2586 | Here is an example: | 2586 | Here is an example: |
2587 | <literallayout class='monospaced'> | 2587 | <literallayout class='monospaced'> |
2588 | FEATURE_PACKAGES_widget = "package1 package2" | 2588 | FEATURE_PACKAGES_widget = "<replaceable>package1</replaceable> <replaceable>package2</replaceable>" |
2589 | </literallayout> | 2589 | </literallayout> |
2590 | In this example, if "widget" were added to | 2590 | In this example, if "widget" were added to |
2591 | <filename>IMAGE_FEATURES</filename>, "package1" and | 2591 | <filename>IMAGE_FEATURES</filename>, <replaceable>package1</replaceable> and |
2592 | "package2" would be included in the image. | 2592 | <replaceable>package2</replaceable> would be included in the image. |
2593 | <note> | 2593 | <note> |
2594 | Packages installed by features defined through | 2594 | Packages installed by features defined through |
2595 | <filename>FEATURE_PACKAGES</filename> are often package | 2595 | <filename>FEATURE_PACKAGES</filename> are often package |
@@ -3468,7 +3468,7 @@ | |||
3468 | <para> | 3468 | <para> |
3469 | When you use this variable, it is best to use it as follows: | 3469 | When you use this variable, it is best to use it as follows: |
3470 | <literallayout class='monospaced'> | 3470 | <literallayout class='monospaced'> |
3471 | IMAGE_INSTALL_append = " package-name" | 3471 | IMAGE_INSTALL_append = " <replaceable>package-name</replaceable>" |
3472 | </literallayout> | 3472 | </literallayout> |
3473 | Be sure to include the space between the quotation character | 3473 | Be sure to include the space between the quotation character |
3474 | and the start of the package name or names. | 3474 | and the start of the package name or names. |
@@ -3520,7 +3520,7 @@ | |||
3520 | The file contains package information on a line-per-package | 3520 | The file contains package information on a line-per-package |
3521 | basis as follows: | 3521 | basis as follows: |
3522 | <literallayout class='monospaced'> | 3522 | <literallayout class='monospaced'> |
3523 | <packagename> <packagearch> <version> | 3523 | <replaceable>packagename</replaceable> <replaceable>packagearch</replaceable> <replaceable>version</replaceable> |
3524 | </literallayout> | 3524 | </literallayout> |
3525 | </para> | 3525 | </para> |
3526 | 3526 | ||
@@ -3653,7 +3653,7 @@ | |||
3653 | OpenEmbedded build system has created the image. | 3653 | OpenEmbedded build system has created the image. |
3654 | You can specify shell commands separated by semicolons: | 3654 | You can specify shell commands separated by semicolons: |
3655 | <literallayout class='monospaced'> | 3655 | <literallayout class='monospaced'> |
3656 | IMAGE_POSTPROCESS_COMMAND += "<shell_command>; ... " | 3656 | IMAGE_POSTPROCESS_COMMAND += "<replaceable>shell_command</replaceable>; ... " |
3657 | </literallayout> | 3657 | </literallayout> |
3658 | If you need to pass the path to the root filesystem within | 3658 | If you need to pass the path to the root filesystem within |
3659 | the command, you can use | 3659 | the command, you can use |
@@ -4458,7 +4458,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
4458 | <para> | 4458 | <para> |
4459 | Specify it as follows: | 4459 | Specify it as follows: |
4460 | <literallayout class='monospaced'> | 4460 | <literallayout class='monospaced'> |
4461 | KERNEL_MODULE_AUTOLOAD += "modname1 modname2 modname3" | 4461 | KERNEL_MODULE_AUTOLOAD += "<replaceable>module_name1</replaceable> <replaceable>module_name2</replaceable> <replaceable>module_name3</replaceable>" |
4462 | </literallayout> | 4462 | </literallayout> |
4463 | </para> | 4463 | </para> |
4464 | 4464 | ||
@@ -4470,7 +4470,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
4470 | The modules appear one-per-line in the file. | 4470 | The modules appear one-per-line in the file. |
4471 | Here is an example of the most common use case: | 4471 | Here is an example of the most common use case: |
4472 | <literallayout class='monospaced'> | 4472 | <literallayout class='monospaced'> |
4473 | KERNEL_MODULE_AUTOLOAD += "modname" | 4473 | KERNEL_MODULE_AUTOLOAD += "<replaceable>module_name</replaceable>" |
4474 | </literallayout> | 4474 | </literallayout> |
4475 | </para> | 4475 | </para> |
4476 | 4476 | ||
@@ -4489,7 +4489,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
4489 | <para> | 4489 | <para> |
4490 | Provides a list of modules for which the OpenEmbedded | 4490 | Provides a list of modules for which the OpenEmbedded |
4491 | build system expects to find | 4491 | build system expects to find |
4492 | <link linkend='var-module_conf'><filename>module_conf_<modname></filename></link> | 4492 | <filename>module_conf_</filename><replaceable>modname</replaceable> |
4493 | values that specify configuration for each of the modules. | 4493 | values that specify configuration for each of the modules. |
4494 | For information on how to provide those module | 4494 | For information on how to provide those module |
4495 | configurations, see the | 4495 | configurations, see the |
@@ -4505,7 +4505,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
4505 | The location of the kernel sources. | 4505 | The location of the kernel sources. |
4506 | This variable is set to the value of the | 4506 | This variable is set to the value of the |
4507 | <link linkend='var-STAGING_KERNEL_DIR'><filename>STAGING_KERNEL_DIR</filename></link> | 4507 | <link linkend='var-STAGING_KERNEL_DIR'><filename>STAGING_KERNEL_DIR</filename></link> |
4508 | within the <filename>module.bbclass</filename> class. | 4508 | within the |
4509 | <link linkend='ref-classes-module'><filename>module</filename></link> | ||
4510 | class. | ||
4509 | For information on how this variable is used, see the | 4511 | For information on how this variable is used, see the |
4510 | "<ulink url='&YOCTO_DOCS_KERNEL_DEV_URL;#incorporating-out-of-tree-modules'>Incorporating Out-of-Tree Modules</ulink>" | 4512 | "<ulink url='&YOCTO_DOCS_KERNEL_DEV_URL;#incorporating-out-of-tree-modules'>Incorporating Out-of-Tree Modules</ulink>" |
4511 | section. | 4513 | section. |
@@ -4530,7 +4532,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
4530 | The location of the kernel sources. | 4532 | The location of the kernel sources. |
4531 | This variable is set to the value of the | 4533 | This variable is set to the value of the |
4532 | <link linkend='var-STAGING_KERNEL_DIR'><filename>STAGING_KERNEL_DIR</filename></link> | 4534 | <link linkend='var-STAGING_KERNEL_DIR'><filename>STAGING_KERNEL_DIR</filename></link> |
4533 | within the <filename>module.bbclass</filename> class. | 4535 | within the |
4536 | <link linkend='ref-classes-module'><filename>module</filename></link> | ||
4537 | class. | ||
4534 | For information on how this variable is used, see the | 4538 | For information on how this variable is used, see the |
4535 | "<ulink url='&YOCTO_DOCS_KERNEL_DEV_URL;#incorporating-out-of-tree-modules'>Incorporating Out-of-Tree Modules</ulink>" | 4539 | "<ulink url='&YOCTO_DOCS_KERNEL_DEV_URL;#incorporating-out-of-tree-modules'>Incorporating Out-of-Tree Modules</ulink>" |
4536 | section. | 4540 | section. |
@@ -4796,10 +4800,10 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
4796 | <para> | 4800 | <para> |
4797 | This variable must be defined for all recipes (unless | 4801 | This variable must be defined for all recipes (unless |
4798 | <link linkend='var-LICENSE'><filename>LICENSE</filename></link> | 4802 | <link linkend='var-LICENSE'><filename>LICENSE</filename></link> |
4799 | is set to "CLOSED")</para> | 4803 | is set to "CLOSED").</para> |
4800 | <para>For more information, see the | 4804 | <para>For more information, see the |
4801 | <link linkend='usingpoky-configuring-LIC_FILES_CHKSUM'> | 4805 | "<link linkend='usingpoky-configuring-LIC_FILES_CHKSUM'> |
4802 | Tracking License Changes</link> section</para> | 4806 | Tracking License Changes</link>" section.</para> |
4803 | </glossdef> | 4807 | </glossdef> |
4804 | </glossentry> | 4808 | </glossentry> |
4805 | 4809 | ||
@@ -4912,7 +4916,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
4912 | The <filename>LICENSE_PATH</filename> variable allows you to extend that | 4916 | The <filename>LICENSE_PATH</filename> variable allows you to extend that |
4913 | location to other areas that have additional licenses: | 4917 | location to other areas that have additional licenses: |
4914 | <literallayout class='monospaced'> | 4918 | <literallayout class='monospaced'> |
4915 | LICENSE_PATH += "/path/to/additional/common/licenses" | 4919 | LICENSE_PATH += "<replaceable>path-to-additional-common-licenses</replaceable>" |
4916 | </literallayout></para> | 4920 | </literallayout></para> |
4917 | </glossdef> | 4921 | </glossdef> |
4918 | </glossentry> | 4922 | </glossentry> |
@@ -5407,7 +5411,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
5407 | <para> | 5411 | <para> |
5408 | Here is the general syntax: | 5412 | Here is the general syntax: |
5409 | <literallayout class='monospaced'> | 5413 | <literallayout class='monospaced'> |
5410 | module_conf_<modname> = "<modprobe.d syntax>" | 5414 | module_conf_<replaceable>module_name</replaceable> = "<replaceable>modprobe.d-syntax</replaceable>" |
5411 | </literallayout> | 5415 | </literallayout> |
5412 | You must use the kernel module name override. | 5416 | You must use the kernel module name override. |
5413 | </para> | 5417 | </para> |
@@ -5531,7 +5535,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
5531 | <filename>local.conf</filename> file or you can attach it to | 5535 | <filename>local.conf</filename> file or you can attach it to |
5532 | a specific image recipe by using the recipe name override: | 5536 | a specific image recipe by using the recipe name override: |
5533 | <literallayout class='monospaced'> | 5537 | <literallayout class='monospaced'> |
5534 | NO_RECOMMENDATIONS_pn-<target_image> = "<package_name>" | 5538 | NO_RECOMMENDATIONS_pn-<replaceable>target_image</replaceable> = "<replaceable>package_name</replaceable>" |
5535 | </literallayout> | 5539 | </literallayout> |
5536 | </para> | 5540 | </para> |
5537 | 5541 | ||
@@ -5909,13 +5913,13 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
5909 | Lists packages that should not be installed into an image. | 5913 | Lists packages that should not be installed into an image. |
5910 | For example: | 5914 | For example: |
5911 | <literallayout class='monospaced'> | 5915 | <literallayout class='monospaced'> |
5912 | PACKAGE_EXCLUDE = "<package_name> <package_name> <package_name> ..." | 5916 | PACKAGE_EXCLUDE = "<replaceable>package_name</replaceable> <replaceable>package_name</replaceable> <replaceable>package_name</replaceable> ..." |
5913 | </literallayout> | 5917 | </literallayout> |
5914 | You can set this variable globally in your | 5918 | You can set this variable globally in your |
5915 | <filename>local.conf</filename> file or you can attach it to | 5919 | <filename>local.conf</filename> file or you can attach it to |
5916 | a specific image recipe by using the recipe name override: | 5920 | a specific image recipe by using the recipe name override: |
5917 | <literallayout class='monospaced'> | 5921 | <literallayout class='monospaced'> |
5918 | PACKAGE_EXCLUDE_pn-<target_image> = "<package_name>" | 5922 | PACKAGE_EXCLUDE_pn-<replaceable>target_image</replaceable> = "<replaceable>package_name</replaceable>" |
5919 | </literallayout> | 5923 | </literallayout> |
5920 | </para> | 5924 | </para> |
5921 | 5925 | ||
@@ -6099,8 +6103,8 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
6099 | <itemizedlist> | 6103 | <itemizedlist> |
6100 | <listitem><para><emphasis>Append file:</emphasis> | 6104 | <listitem><para><emphasis>Append file:</emphasis> |
6101 | Create an append file named | 6105 | Create an append file named |
6102 | <filename><recipename>.bbappend</filename> in your | 6106 | <replaceable>recipename</replaceable><filename>.bbappend</filename> |
6103 | layer and override the value of | 6107 | in your layer and override the value of |
6104 | <filename>PACKAGECONFIG</filename>. | 6108 | <filename>PACKAGECONFIG</filename>. |
6105 | You can either completely override the variable: | 6109 | You can either completely override the variable: |
6106 | <literallayout class='monospaced'> | 6110 | <literallayout class='monospaced'> |
@@ -6114,15 +6118,15 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
6114 | This method is identical to changing the block | 6118 | This method is identical to changing the block |
6115 | through an append file except you edit your | 6119 | through an append file except you edit your |
6116 | <filename>local.conf</filename> or | 6120 | <filename>local.conf</filename> or |
6117 | <filename><mydistro>.conf</filename> file. | 6121 | <filename><replaceable>mydistro</replaceable>.conf</filename> file. |
6118 | As with append files previously described, | 6122 | As with append files previously described, |
6119 | you can either completely override the variable: | 6123 | you can either completely override the variable: |
6120 | <literallayout class='monospaced'> | 6124 | <literallayout class='monospaced'> |
6121 | PACKAGECONFIG_pn-<recipename>="f4 f5" | 6125 | PACKAGECONFIG_pn-<replaceable>recipename</replaceable>="f4 f5" |
6122 | </literallayout> | 6126 | </literallayout> |
6123 | Or, you can just amend the variable: | 6127 | Or, you can just amend the variable: |
6124 | <literallayout class='monospaced'> | 6128 | <literallayout class='monospaced'> |
6125 | PACKAGECONFIG_append_pn-<recipename> = " f4" | 6129 | PACKAGECONFIG_append_pn-<replaceable>recipename</replaceable> = " f4" |
6126 | </literallayout></para></listitem> | 6130 | </literallayout></para></listitem> |
6127 | </itemizedlist> | 6131 | </itemizedlist> |
6128 | </para> | 6132 | </para> |
@@ -6345,7 +6349,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
6345 | For example, when the | 6349 | For example, when the |
6346 | <link linkend='ref-classes-debian'><filename>debian</filename></link> | 6350 | <link linkend='ref-classes-debian'><filename>debian</filename></link> |
6347 | class renames the output package, it does so by setting | 6351 | class renames the output package, it does so by setting |
6348 | <filename>PKG_<packagename></filename>. | 6352 | <filename>PKG_<replaceable>packagename</replaceable></filename>. |
6349 | </para> | 6353 | </para> |
6350 | </glossdef> | 6354 | </glossdef> |
6351 | </glossentry> | 6355 | </glossentry> |
@@ -6868,7 +6872,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
6868 | them in conjunction with a package name override. | 6872 | them in conjunction with a package name override. |
6869 | Here is an example: | 6873 | Here is an example: |
6870 | <literallayout class='monospaced'> | 6874 | <literallayout class='monospaced'> |
6871 | RCONFLICTS_${PN} = "another-conflicting-package-name" | 6875 | RCONFLICTS_${PN} = "<replaceable>another-conflicting-package-name</replaceable>" |
6872 | </literallayout> | 6876 | </literallayout> |
6873 | </para> | 6877 | </para> |
6874 | 6878 | ||
@@ -6880,7 +6884,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
6880 | Here is the general syntax to specify versions with | 6884 | Here is the general syntax to specify versions with |
6881 | the <filename>RCONFLICTS</filename> variable: | 6885 | the <filename>RCONFLICTS</filename> variable: |
6882 | <literallayout class='monospaced'> | 6886 | <literallayout class='monospaced'> |
6883 | RCONFLICTS_${PN} = "<package> (<operator> <version>)" | 6887 | RCONFLICTS_${PN} = "<replaceable>package</replaceable> (<replaceable>operator</replaceable> <replaceable>version</replaceable>)" |
6884 | </literallayout> | 6888 | </literallayout> |
6885 | For <filename>operator</filename>, you can specify the | 6889 | For <filename>operator</filename>, you can specify the |
6886 | following: | 6890 | following: |
@@ -6972,7 +6976,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
6972 | as it would in the <filename>PACKAGES</filename> | 6976 | as it would in the <filename>PACKAGES</filename> |
6973 | namespace before any renaming of the output package by | 6977 | namespace before any renaming of the output package by |
6974 | classes like | 6978 | classes like |
6975 | <link linkend='ref-classes-debian'><filename>debian.bbclass</filename></link>. | 6979 | <link linkend='ref-classes-debian'><filename>debian</filename></link>. |
6976 | </para> | 6980 | </para> |
6977 | 6981 | ||
6978 | <para> | 6982 | <para> |
@@ -7006,7 +7010,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
7006 | Here is the general syntax to specify versions with | 7010 | Here is the general syntax to specify versions with |
7007 | the <filename>RDEPENDS</filename> variable: | 7011 | the <filename>RDEPENDS</filename> variable: |
7008 | <literallayout class='monospaced'> | 7012 | <literallayout class='monospaced'> |
7009 | RDEPENDS_${PN} = "<package> (<operator> <version>)" | 7013 | RDEPENDS_${PN} = "<replaceable>package</replaceable> (<replaceable>operator</replaceable> <replaceable>version</replaceable>)" |
7010 | </literallayout> | 7014 | </literallayout> |
7011 | For <filename>operator</filename>, you can specify the | 7015 | For <filename>operator</filename>, you can specify the |
7012 | following: | 7016 | following: |
@@ -7136,7 +7140,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
7136 | OpenEmbedded build system has created the root filesystem. | 7140 | OpenEmbedded build system has created the root filesystem. |
7137 | You can specify shell commands separated by semicolons: | 7141 | You can specify shell commands separated by semicolons: |
7138 | <literallayout class='monospaced'> | 7142 | <literallayout class='monospaced'> |
7139 | ROOTFS_POSTPROCESS_COMMAND += "<shell_command>; ... " | 7143 | ROOTFS_POSTPROCESS_COMMAND += "<replaceable>shell_command</replaceable>; ... " |
7140 | </literallayout> | 7144 | </literallayout> |
7141 | If you need to pass the path to the root filesystem within | 7145 | If you need to pass the path to the root filesystem within |
7142 | the command, you can use | 7146 | the command, you can use |
@@ -7224,7 +7228,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
7224 | that is extended to support wireless functionality. | 7228 | that is extended to support wireless functionality. |
7225 | In this case, you would use the following: | 7229 | In this case, you would use the following: |
7226 | <literallayout class='monospaced'> | 7230 | <literallayout class='monospaced'> |
7227 | RRECOMMENDS_${PN}-dev += "<wireless_package_name>" | 7231 | RRECOMMENDS_${PN}-dev += "<replaceable>wireless_package_name</replaceable>" |
7228 | </literallayout> | 7232 | </literallayout> |
7229 | In the example, the package name | 7233 | In the example, the package name |
7230 | (<filename>${<link linkend='var-PN'>PN</link>}-dev</filename>) | 7234 | (<filename>${<link linkend='var-PN'>PN</link>}-dev</filename>) |
@@ -7242,7 +7246,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
7242 | Here is the general syntax to specify versions with | 7246 | Here is the general syntax to specify versions with |
7243 | the <filename>RRECOMMENDS</filename> variable: | 7247 | the <filename>RRECOMMENDS</filename> variable: |
7244 | <literallayout class='monospaced'> | 7248 | <literallayout class='monospaced'> |
7245 | RRECOMMENDS_${PN} = "<package> (<operator> <version>)" | 7249 | RRECOMMENDS_${PN} = "<replaceable>package</replaceable> (<replaceable>operator</replaceable> <replaceable>version</replaceable>)" |
7246 | </literallayout> | 7250 | </literallayout> |
7247 | For <filename>operator</filename>, you can specify the | 7251 | For <filename>operator</filename>, you can specify the |
7248 | following: | 7252 | following: |
@@ -7280,7 +7284,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
7280 | override. | 7284 | override. |
7281 | Here is an example: | 7285 | Here is an example: |
7282 | <literallayout class='monospaced'> | 7286 | <literallayout class='monospaced'> |
7283 | RREPLACES_${PN} = "other-package-being-replaced" | 7287 | RREPLACES_${PN} = "<replaceable>other-package-being-replaced</replaceable>" |
7284 | </literallayout> | 7288 | </literallayout> |
7285 | </para> | 7289 | </para> |
7286 | 7290 | ||
@@ -7292,7 +7296,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
7292 | Here is the general syntax to specify versions with | 7296 | Here is the general syntax to specify versions with |
7293 | the <filename>RREPLACES</filename> variable: | 7297 | the <filename>RREPLACES</filename> variable: |
7294 | <literallayout class='monospaced'> | 7298 | <literallayout class='monospaced'> |
7295 | RREPLACES_${PN} = "<package> (<operator> <version>)" | 7299 | RREPLACES_${PN} = "<replaceable>package</replaceable> (<replaceable>operator</replaceable> <replaceable>version</replaceable>)" |
7296 | </literallayout> | 7300 | </literallayout> |
7297 | For <filename>operator</filename>, you can specify the | 7301 | For <filename>operator</filename>, you can specify the |
7298 | following: | 7302 | following: |
@@ -7327,7 +7331,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
7327 | override. | 7331 | override. |
7328 | Here is an example: | 7332 | Here is an example: |
7329 | <literallayout class='monospaced'> | 7333 | <literallayout class='monospaced'> |
7330 | RSUGGESTS_${PN} = "useful-package another-package" | 7334 | RSUGGESTS_${PN} = "<replaceable>useful-package</replaceable> <replaceable>another-package</replaceable>" |
7331 | </literallayout> | 7335 | </literallayout> |
7332 | </para> | 7336 | </para> |
7333 | </glossdef> | 7337 | </glossdef> |
@@ -7503,7 +7507,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
7503 | However, this variable applies to the SDK generated from an | 7507 | However, this variable applies to the SDK generated from an |
7504 | image using the following command: | 7508 | image using the following command: |
7505 | <literallayout class='monospaced'> | 7509 | <literallayout class='monospaced'> |
7506 | $ bitbake -c populate_sdk imagename | 7510 | $ bitbake -c populate_sdk <replaceable>imagename</replaceable> |
7507 | </literallayout> | 7511 | </literallayout> |
7508 | </para> | 7512 | </para> |
7509 | </glossdef> | 7513 | </glossdef> |
@@ -8083,8 +8087,8 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
8083 | directory structure. | 8087 | directory structure. |
8084 | <literallayout class='monospaced'> | 8088 | <literallayout class='monospaced'> |
8085 | SSTATE_MIRRORS ?= "\ | 8089 | SSTATE_MIRRORS ?= "\ |
8086 | file://.* http://someserver.tld/share/sstate/PATH \n \ | 8090 | file://.* http://<replaceable>someserver</replaceable>.tld/share/sstate/PATH \n \ |
8087 | file://.* file:///some/local/dir/sstate/PATH" | 8091 | file://.* file:///<replaceable>some-local-dir</replaceable>/sstate/PATH" |
8088 | </literallayout> | 8092 | </literallayout> |
8089 | </para> | 8093 | </para> |
8090 | </glossdef> | 8094 | </glossdef> |
@@ -9090,7 +9094,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
9090 | You can add your own tests to the list of tests by | 9094 | You can add your own tests to the list of tests by |
9091 | appending <filename>TEST_SUITES</filename> as follows: | 9095 | appending <filename>TEST_SUITES</filename> as follows: |
9092 | <literallayout class='monospaced'> | 9096 | <literallayout class='monospaced'> |
9093 | TEST_SUITES_append = " mytest" | 9097 | TEST_SUITES_append = " <replaceable>mytest</replaceable>" |
9094 | </literallayout> | 9098 | </literallayout> |
9095 | Alternatively, you can provide the "auto" option to | 9099 | Alternatively, you can provide the "auto" option to |
9096 | have all applicable tests run against the image. | 9100 | have all applicable tests run against the image. |
@@ -9511,11 +9515,11 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
9511 | </glossdef> | 9515 | </glossdef> |
9512 | </glossentry> | 9516 | </glossentry> |
9513 | 9517 | ||
9514 | <glossentry id='var-TUNECONFLICT'><glossterm>TUNECONFLICT[<feature>]</glossterm> | 9518 | <glossentry id='var-TUNECONFLICT'><glossterm>TUNECONFLICT[<replaceable>feature</replaceable>]</glossterm> |
9515 | <glossdef> | 9519 | <glossdef> |
9516 | <para> | 9520 | <para> |
9517 | Specifies CPU or Application Binary Interface (ABI) | 9521 | Specifies CPU or Application Binary Interface (ABI) |
9518 | tuning features that conflict with >feature<. | 9522 | tuning features that conflict with <replaceable>feature</replaceable>. |
9519 | </para> | 9523 | </para> |
9520 | 9524 | ||
9521 | <para> | 9525 | <para> |
@@ -9533,7 +9537,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
9533 | </glossdef> | 9537 | </glossdef> |
9534 | </glossentry> | 9538 | </glossentry> |
9535 | 9539 | ||
9536 | <glossentry id='var-TUNEVALID'><glossterm>TUNEVALID[<feature>]</glossterm> | 9540 | <glossentry id='var-TUNEVALID'><glossterm>TUNEVALID[<replaceable>feature</replaceable>]</glossterm> |
9537 | <glossdef> | 9541 | <glossdef> |
9538 | <para> | 9542 | <para> |
9539 | Specifies a valid CPU or Application Binary Interface (ABI) | 9543 | Specifies a valid CPU or Application Binary Interface (ABI) |
@@ -9644,7 +9648,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
9644 | The value indicates the target platform configuration. | 9648 | The value indicates the target platform configuration. |
9645 | You typically set this variable from the machine | 9649 | You typically set this variable from the machine |
9646 | configuration file (i.e. | 9650 | configuration file (i.e. |
9647 | <filename>conf/machine/<machine_name>.conf</filename>). | 9651 | <filename>conf/machine/<replaceable>machine_name</replaceable>.conf</filename>). |
9648 | </para> | 9652 | </para> |
9649 | 9653 | ||
9650 | <para> | 9654 | <para> |