diff mbox

[yocto-docs] ref-manual: add usage NOTE to IMAGE_FSTYPES

Message ID 1385331570-22164-1-git-send-email-trevor.woerner@linaro.org
State New
Headers show

Commit Message

Trevor Woerner Nov. 24, 2013, 10:19 p.m. UTC
Due to the way in which IMAGE_FSTYPES is processed, it is not possible to
modify it using _append or _prepend. Therefore add a note to the manual to
warn users in case they stumble on this issue.

Signed-off-by: Trevor Woerner <trevor.woerner@linaro.org>
---
 documentation/ref-manual/ref-variables.xml | 9 +++++++++
 1 file changed, 9 insertions(+)

Comments

Rifenbark, Scott M Nov. 25, 2013, 9:48 p.m. UTC | #1
Applied Trevor...thanks.

Scott

>-----Original Message-----
>From: yocto-bounces@yoctoproject.org [mailto:yocto-
>bounces@yoctoproject.org] On Behalf Of Trevor Woerner
>Sent: Sunday, November 24, 2013 2:20 PM
>To: yocto@yoctoproject.org
>Cc: patches@linaro.org
>Subject: [yocto] [yocto-docs][PATCH] ref-manual: add usage NOTE to
>IMAGE_FSTYPES
>
>Due to the way in which IMAGE_FSTYPES is processed, it is not possible to
>modify it using _append or _prepend. Therefore add a note to the manual to
>warn users in case they stumble on this issue.
>
>Signed-off-by: Trevor Woerner <trevor.woerner@linaro.org>
>---
> documentation/ref-manual/ref-variables.xml | 9 +++++++++
> 1 file changed, 9 insertions(+)
>
>diff --git a/documentation/ref-manual/ref-variables.xml
>b/documentation/ref-manual/ref-variables.xml
>index fb33791..67ea422 100644
>--- a/documentation/ref-manual/ref-variables.xml
>+++ b/documentation/ref-manual/ref-variables.xml
>@@ -2199,6 +2199,15 @@
>                     you can choose, see
>                     <link linkend='var-
>IMAGE_TYPES'><filename>IMAGE_TYPES</filename></link>.
>                 </para>
>+
>+                <note>
>+                    Due to the way this variable is processed, it is not
>+                    possible to update its contents using
>+                    <filename>_append</filename> or
>+                    <filename>_prepend</filename>. To add one or more
>+                    additional options to this variable the
>+                    <filename>+=</filename> operator must be used.
>+                </note>
>             </glossdef>
>         </glossentry>
>
>--
>1.8.4.474.g128a96c
>
>_______________________________________________
>yocto mailing list
>yocto@yoctoproject.org
>https://lists.yoctoproject.org/listinfo/yocto
diff mbox

Patch

diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index fb33791..67ea422 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -2199,6 +2199,15 @@ 
                     you can choose, see
                     <link linkend='var-IMAGE_TYPES'><filename>IMAGE_TYPES</filename></link>.
                 </para>
+
+                <note>
+                    Due to the way this variable is processed, it is not
+                    possible to update its contents using
+                    <filename>_append</filename> or
+                    <filename>_prepend</filename>. To add one or more
+                    additional options to this variable the
+                    <filename>+=</filename> operator must be used.
+                </note>
             </glossdef>
         </glossentry>