diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 44b046d965..5694776b88 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -2249,6 +2249,19 @@
Typically, setting these options is accomplished by running a
configure script with some options, or by modifying a build
configuration file.
+
+ As of Yocto Project Release 7.1, some of the core recipes
+ that package binary configuration scripts now disable the
+ scripts due to the scripts previously requiring error-prone
+ path substitution.
+ The OpenEmbedded build system uses
+ pkg-config now, which is much more
+ robust.
+ You can find a list of the *-config
+ scripts that are disabled list in the
+ "Binary Configuration Scripts Disabled"
+ section in the Yocto Project Reference Manual.
+
@@ -2364,7 +2377,16 @@
However, if the compile step fails, you need to diagnose the
failure.
- Here are some common issues that cause failures:
+ Here are some common issues that cause failures.
+
+ For cases where improper paths are detected for
+ configuration files or for when libraries/headers cannot
+ be found, be sure you are using the more robust
+ pkg-config.
+ See the note in section
+ "Configuring the Recipe"
+ for additional information.
+ Parallel build failures:
These failures manifest themselves as intermittent