[gnome-continuous-yocto/gnomeostree-3.28-rocko: 2307/8267] bitbake: lib/bb/utils: edit_metadata() comment tweaks

[Emmanuele Bassi <ebassi src gnome org>]

commit ee7c6d00bb19b762f40702aada93bac568777d24
Author: Paul Eggleton <paul eggleton linux intel com>
Date:   Tue Sep 6 10:57:33 2016 +1200

    bitbake: lib/bb/utils: edit_metadata() comment tweaks
    
    No functional changes, just make a couple of minor tweaks to the
    comments for edit_metadata():
    
    * There are four elements to be returned by the callback function
    * Add an example return statement for when you don't want to modify the
      value
    
    (Bitbake rev: 99675c19375c96140bc8ae8f9fc3a1945a77cebb)
    
    Signed-off-by: Paul Eggleton <paul eggleton linux intel com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 bitbake/lib/bb/utils.py |    4 +++-
 1 files changed, 3 insertions(+), 1 deletions(-)
---
diff --git a/bitbake/lib/bb/utils.py b/bitbake/lib/bb/utils.py
index a855d58..729848a 100644
--- a/bitbake/lib/bb/utils.py
+++ b/bitbake/lib/bb/utils.py
@@ -1081,7 +1081,7 @@ def edit_metadata(meta_lines, variables, varfunc, match_overrides=False):
                 newlines: list of lines up to this point. You can use
                     this to prepend lines before this variable setting
                     if you wish.
-            and should return a three-element tuple:
+            and should return a four-element tuple:
                 newvalue: new value to substitute in, or None to drop
                     the variable setting entirely. (If the removal
                     results in two consecutive blank lines, one of the
@@ -1095,6 +1095,8 @@ def edit_metadata(meta_lines, variables, varfunc, match_overrides=False):
                     multi-line value to continue on the same line as
                     the assignment, False to indent before the first
                     element.
+            To clarify, if you wish not to change the value, then you
+            would return like this: return origvalue, None, 0, True
         match_overrides: True to match items with _overrides on the end,
             False otherwise
     Returns a tuple: