From 84ee8c653a45ffbda1fd3773f5fbb67d20d1bfc3 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Mon, 2 Jun 2014 15:22:28 +0300 Subject: ref-manual, dev-manual: Updates for custom template configuration directory. Fixes [YOCTO #5895] I created a new section in the dev-manual titles "Creating a Custom Template Configuration Directory" that describes how the build system uses the template local.conf and bblayers.conf and conf-notes.txt files as a basis when creating the real deals in the build directory's conf folder. The context of this is so that the user can create their own directory with their own template files for repeated configurations and to create a custom conf-notes.txt file should they want the setup scripts to display some custom list of targets. I also modified the two script references in the ref-manual for oe-init-build-env and oe-init-build-env-memres. I needed to link to the "how-to" section and added a bit in there about how the scripts go about forming the conf files in the build directory. (From yocto-docs rev: c07fb7082fe08387bbc546b2a23620dedc7127b8) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/ref-manual/ref-structure.xml | 28 ++++++++++++++++++++++++---- 1 file changed, 24 insertions(+), 4 deletions(-) (limited to 'documentation/ref-manual') diff --git a/documentation/ref-manual/ref-structure.xml b/documentation/ref-manual/ref-structure.xml index 1549d90357..c849dbda33 100644 --- a/documentation/ref-manual/ref-structure.xml +++ b/documentation/ref-manual/ref-structure.xml @@ -240,8 +240,10 @@ Should you have custom distributions, it is very easy to modify this configuration file to include your targets for your distribution. - Simply edit the list within the file and when you run the - environment setup script you see your customized list of targets. + See the + "Creating a Custom Template Configuration Directory" + section in the Yocto Project Development Manual for more + information. @@ -258,6 +260,14 @@ $ source &OE_INIT_FILE; ~/mybuilds + The OpenEmbedded build system uses the template configuration + files, which are found by default in the + meta-yocto/conf directory in the + Source Directory. + See the + "Creating a Custom Template Configuration Directory" + section in the Yocto Project Development Manual for more + information. The OpenEmbedded build system does not support file or directory names that contain spaces. @@ -349,8 +359,10 @@ Should you have custom distributions, it is very easy to modify this configuration file to include your targets for your distribution. - Simply edit the list within the file and when you run the - environment setup script you see your customized list of targets. + See the + "Creating a Custom Template Configuration Directory" + section in the Yocto Project Development Manual for more + information. @@ -368,6 +380,14 @@ $ source oe-init-build-env-memres ~/mybuilds + The OpenEmbedded build system uses the template configuration + files, which are found by default in the + meta-yocto/conf directory in the + Source Directory. + See the + "Creating a Custom Template Configuration Directory" + section in the Yocto Project Development Manual for more + information. The OpenEmbedded build system does not support file or directory names that contain spaces. -- cgit v1.2.3-54-g00ecf