diff options
Diffstat (limited to 'documentation/ref-manual/features.rst')
-rw-r--r-- | documentation/ref-manual/features.rst | 22 |
1 files changed, 11 insertions, 11 deletions
diff --git a/documentation/ref-manual/features.rst b/documentation/ref-manual/features.rst index 31d24b8c28..ded653221c 100644 --- a/documentation/ref-manual/features.rst +++ b/documentation/ref-manual/features.rst | |||
@@ -10,10 +10,10 @@ can select, and a reference on feature backfilling. | |||
10 | 10 | ||
11 | Features provide a mechanism for working out which packages should be | 11 | Features provide a mechanism for working out which packages should be |
12 | included in the generated images. Distributions can select which | 12 | included in the generated images. Distributions can select which |
13 | features they want to support through the ``DISTRO_FEATURES`` variable, | 13 | features they want to support through the :term:`DISTRO_FEATURES` variable, |
14 | which is set or appended to in a distribution's configuration file such | 14 | which is set or appended to in a distribution's configuration file such |
15 | as ``poky.conf``, ``poky-tiny.conf``, ``poky-lsb.conf`` and so forth. | 15 | as ``poky.conf``, ``poky-tiny.conf``, ``poky-lsb.conf`` and so forth. |
16 | Machine features are set in the ``MACHINE_FEATURES`` variable, which is | 16 | Machine features are set in the :term:`MACHINE_FEATURES` variable, which is |
17 | set in the machine configuration file and specifies the hardware | 17 | set in the machine configuration file and specifies the hardware |
18 | features for a given machine. | 18 | features for a given machine. |
19 | 19 | ||
@@ -267,7 +267,7 @@ these valid features is as follows: | |||
267 | - *ssh-server-openssh:* Installs the OpenSSH SSH server, which is more | 267 | - *ssh-server-openssh:* Installs the OpenSSH SSH server, which is more |
268 | full-featured than Dropbear. Note that if both the OpenSSH SSH server | 268 | full-featured than Dropbear. Note that if both the OpenSSH SSH server |
269 | and the Dropbear minimal SSH server are present in | 269 | and the Dropbear minimal SSH server are present in |
270 | ``IMAGE_FEATURES``, then OpenSSH will take precedence and Dropbear | 270 | :term:`IMAGE_FEATURES`, then OpenSSH will take precedence and Dropbear |
271 | will not be installed. | 271 | will not be installed. |
272 | 272 | ||
273 | - *tools-debug:* Installs debugging tools such as ``strace`` and | 273 | - *tools-debug:* Installs debugging tools such as ``strace`` and |
@@ -323,27 +323,27 @@ Here are two examples to help illustrate feature backfilling: | |||
323 | - *The "pulseaudio" distro feature option*: Previously, PulseAudio | 323 | - *The "pulseaudio" distro feature option*: Previously, PulseAudio |
324 | support was enabled within the Qt and GStreamer frameworks. Because | 324 | support was enabled within the Qt and GStreamer frameworks. Because |
325 | of this, the feature is backfilled and thus enabled for all distros | 325 | of this, the feature is backfilled and thus enabled for all distros |
326 | through the ``DISTRO_FEATURES_BACKFILL`` variable in the | 326 | through the :term:`DISTRO_FEATURES_BACKFILL` variable in the |
327 | ``meta/conf/bitbake.conf`` file. However, your distro needs to | 327 | ``meta/conf/bitbake.conf`` file. However, your distro needs to |
328 | disable the feature. You can disable the feature without affecting | 328 | disable the feature. You can disable the feature without affecting |
329 | other existing distro configurations that need PulseAudio support by | 329 | other existing distro configurations that need PulseAudio support by |
330 | adding "pulseaudio" to ``DISTRO_FEATURES_BACKFILL_CONSIDERED`` in | 330 | adding "pulseaudio" to :term:`DISTRO_FEATURES_BACKFILL_CONSIDERED` in |
331 | your distro's ``.conf`` file. Adding the feature to this variable | 331 | your distro's ``.conf`` file. Adding the feature to this variable |
332 | when it also exists in the ``DISTRO_FEATURES_BACKFILL`` variable | 332 | when it also exists in the :term:`DISTRO_FEATURES_BACKFILL` variable |
333 | prevents the build system from adding the feature to your | 333 | prevents the build system from adding the feature to your |
334 | configuration's ``DISTRO_FEATURES``, effectively disabling the | 334 | configuration's :term:`DISTRO_FEATURES`, effectively disabling the |
335 | feature for that particular distro. | 335 | feature for that particular distro. |
336 | 336 | ||
337 | - *The "rtc" machine feature option*: Previously, real time clock (RTC) | 337 | - *The "rtc" machine feature option*: Previously, real time clock (RTC) |
338 | support was enabled for all target devices. Because of this, the | 338 | support was enabled for all target devices. Because of this, the |
339 | feature is backfilled and thus enabled for all machines through the | 339 | feature is backfilled and thus enabled for all machines through the |
340 | ``MACHINE_FEATURES_BACKFILL`` variable in the | 340 | :term:`MACHINE_FEATURES_BACKFILL` variable in the |
341 | ``meta/conf/bitbake.conf`` file. However, your target device does not | 341 | ``meta/conf/bitbake.conf`` file. However, your target device does not |
342 | have this capability. You can disable RTC support for your device | 342 | have this capability. You can disable RTC support for your device |
343 | without affecting other machines that need RTC support by adding the | 343 | without affecting other machines that need RTC support by adding the |
344 | feature to your machine's ``MACHINE_FEATURES_BACKFILL_CONSIDERED`` | 344 | feature to your machine's :term:`MACHINE_FEATURES_BACKFILL_CONSIDERED` |
345 | list in the machine's ``.conf`` file. Adding the feature to this | 345 | list in the machine's ``.conf`` file. Adding the feature to this |
346 | variable when it also exists in the ``MACHINE_FEATURES_BACKFILL`` | 346 | variable when it also exists in the :term:`MACHINE_FEATURES_BACKFILL` |
347 | variable prevents the build system from adding the feature to your | 347 | variable prevents the build system from adding the feature to your |
348 | configuration's ``MACHINE_FEATURES``, effectively disabling RTC | 348 | configuration's :term:`MACHINE_FEATURES`, effectively disabling RTC |
349 | support for that particular machine. | 349 | support for that particular machine. |