diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 4e37b1bea1..7f2bbc336e 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -2384,27 +2384,34 @@
A common example usage of include files would be to
separate out the selection of desired version and revisions
for individual recipes.
+
+ Your configuration file needs to set the following
+ required variables:
+
+ DISTRO_NAME [required]
+ DISTRO_VERSION [required]
+
+ These following variables are optional and you typically
+ set them from the distribution configuration file:
+
+ DISTRO_FEATURES [optional]
+ DISTRO_EXTRA_RDEPENDS [optional]
+ DISTRO_EXTRA_RRECOMMENDS [optional]
+ TCLIBC [optional]
+
If you want to base your distribution configuration file
on the very basic configuration from OE-Core, you
- can "require"
- conf/distro/defaultsetup.conf.
+ can use
+ conf/distro/defaultsetup.conf as
+ a reference and just include variables that differ
+ as compared to defaultsetup.conf.
Alternatively, you can create a distribution
configuration file from scratch using the
defaultsetup.conf file
or configuration files from other distributions
such as Poky or Angstrom as references.
-
- Your configuration file needs to set the following
- variables:
-
- DISTRO_NAME [required]
- DISTRO_VERSION [required]
- DISTRO_FEATURES [required if creating from scratch]
- DISTRO_EXTRA_RDEPENDS [optional]
- DISTRO_EXTRA_RRECOMMENDS [optional]
- TCLIBC [required if creating from scratch]
-
+
Provide Miscellaneous Variables:
Be sure to define any other variable for which you want to
create a default or enforce as part of the distribution
@@ -3724,36 +3731,27 @@
- NOTES TO SELF:
- systemd is a full replacement of for init with
- parallel starting of services, reduced shell overhead and other
- features, used by many distributions.
- I think you set the VIRTUAL-RUNTIME
- in a recipe.
- I found a recipe called
- packagegroup-core-boot.bb, which is an
- OE-Core recipe, that has a bunch of them.
- The comment refers to the group as "VIRTUAL-RUNTIME providers".
- The list includes VIRTUAL-RUNTIME_dev_manager,
- VIRTUAL-RUNTIME_init_manager,
- VIRTUAL-RUNTIME_login_manager,
- VIRTUAL-RUNTIME_initscripts, and
- VIRTUAL-RUNTIME_keymaps.
+ It is recommended that you create your own distribution configuration
+ file to hold these settings instead of using your
+ local.conf file.
+ For information on creating your own distribution, see the
+ "Creating Your Own Distribution"
+ section.
Using systemd Exclusively
- Set the following variables in your
- local.conf file as follows:
+ Set the following variables in your distribution configuration
+ file as follows:
DISTRO_FEATURES_append = " systemd"
VIRTUAL-RUNTIME_init_manager = "systemd"
- You can save some disk space by adding
- sysvinit to the distribution features
- considered for backfill as follows:
+ You can also prevent the sysvinit
+ distribution feature from
+ being automatically enabled as follows:
DISTRO_FEATURES_BACKFILL_CONSIDERED = "sysvinit"
@@ -3762,12 +3760,12 @@
-
- Use systemd for the Main Image and Use SysVinit for the Rescue Image
+
+ Using systemd for the Main Image and Using SysVinit for the Rescue Image
- Set the following variables in your
- local.conf file as follows:
+ Set the following variables in your distribution configuration
+ file as follows:
DISTRO_FEATURES_append = " systemd"
VIRTUAL-RUNTIME_init_manager = "systemd"
@@ -3775,9 +3773,9 @@
Doing so causes your main image to use the
packagegroup-core-boot.bb recipe and
systemd.
- The rescue/minimal image cannot use this group.
+ The rescue/minimal image cannot use this package group.
However, it can install sysvinit
- and the appropriate packages with have both
+ and the appropriate packages will have support for both
systemd and sysvinit.