diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index f6dd231dce..09e9d5a853 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml @@ -273,29 +273,17 @@ the included file, use the path relative to the original layer directory to refer to the file. For example, use - require recipes-core/somepackage/somefile.inc - instead of require somefile.inc. + require recipes-core/package/file.inc + instead of require file.inc. If you're finding you have to overlay the include file, it could indicate a deficiency in the include file in the layer to which it originally belongs. - If this is the case, you need to address that deficiency - instead of overlaying the include file. - - - - For example, consider how support plug-ins for the Qt 4 - database are configured. - The Source Directory does not have MySQL or PostgreSQL. - However, OpenEmbedded's layer meta-oe - does. - Consequently, meta-oe uses - append files to modify the - QT_SQL_DRIVER_FLAGS variable to - enable the appropriate plug-ins. - This variable was added to the qt4.inc - include file in the Source Directory specifically to allow - the meta-oe layer to be able to control - which plug-ins are built. + If this is the case, you should try to address that + deficiency instead of overlaying the include file. + For example, you could address this by getting the + maintainer of the include file to add a variable or + variables to make it easy to override the parts needing + overwritten.