summaryrefslogtreecommitdiffstats
path: root/templates/feature/agl-devel/README_feature_agl-devel.md
diff options
context:
space:
mode:
Diffstat (limited to 'templates/feature/agl-devel/README_feature_agl-devel.md')
-rw-r--r--templates/feature/agl-devel/README_feature_agl-devel.md42
1 files changed, 42 insertions, 0 deletions
diff --git a/templates/feature/agl-devel/README_feature_agl-devel.md b/templates/feature/agl-devel/README_feature_agl-devel.md
new file mode 100644
index 000000000..24483f95e
--- /dev/null
+++ b/templates/feature/agl-devel/README_feature_agl-devel.md
@@ -0,0 +1,42 @@
+---
+description: Feature agl-devel
+authors: José Bollo <jose.bollo@iot.bzh>, Ronan Le Martret <ronan.lemartret@iot.bzh>, Stephane Desneux <stephane.desneux@iot.bzh>, Yannick Gicquel <yannick.gicquel@iot.bzh>
+---
+
+### Feature agl-devel
+
+Activation of the agl-devel features turns on
+features needed for developping and debugging
+agl distribution.
+
+This includes:
+
+* adding to images some useful packages
+* adding to images the package group 'packagegroup-agl-devel'
+* definition of a contionnal the tag 'agl-devel'
+ for conditionnal building
+
+ * definition of the distro feature 'agl-devel'
+ * adds packages for development in SDK
+
+### How to use agl-devel in conditionnal builds
+
+The following example shows how to activate C/C++ code
+specific to agl-devel:
+
+```yocto
+CPPFLAGS_append_agl-devel = " -DAGL_DEVEL"
+```
+
+Using this, any code enclosed in
+
+```yocto
+#ifdef AGL_DEVEL
+...my code specific to agl-devel...
+#endif
+```
+
+will normaly be effective only if agl-devel is set on.
+
+At this time, it is recommended to use AGL_DEVEL as tag
+within C/C++ code.