[gnome-continuous-yocto/gnomeostree-3.28-rocko: 1652/8267] ref-manual: Updated the do_configure task.

[Emmanuele Bassi <ebassi src gnome org>]

commit 781bff802b3d61214e33ac4026aedb9e113edeb7
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Mon Jul 18 11:58:52 2016 -0700

    ref-manual: Updated the do_configure task.
    
    Added more detail for this task.
    
    Fixes [YOCTO #9965]
    
    (From yocto-docs rev: e50207488b8262bb46e58c4b9f40e487c15abc67)
    
    Signed-off-by: Scott Rifenbark <srifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 documentation/ref-manual/ref-tasks.xml |   14 ++++++++++++++
 1 files changed, 14 insertions(+), 0 deletions(-)
---
diff --git a/documentation/ref-manual/ref-tasks.xml b/documentation/ref-manual/ref-tasks.xml
index 9b1e8e3..97c8a9e 100644
--- a/documentation/ref-manual/ref-tasks.xml
+++ b/documentation/ref-manual/ref-tasks.xml
@@ -100,6 +100,20 @@
         <para>
             Configures the source by enabling and disabling any build-time and
             configuration options for the software being built.
+            The task runs with the current working directory set to
+            <filename>${</filename><link linkend='var-B'><filename>B</filename></link><filename>}</filename>.
+        </para>
+
+        <para>
+            The default behavior of this task is to run
+            <filename>oe_runmake clean</filename> if a makefile
+            (<filename>Makefile</filename>, <filename>makefile</filename>,
+            or <filename>GNUmakefile</filename>) is found and
+            <link linkend='var-CLEANBROKEN'><filename>CLEANBROKEN</filename></link>
+            is not set to "1".
+            If no such file is found or the <filename>CLEANBROKEN</filename>
+            variable is set to "1", the <filename>do_configure</filename>
+            task does nothing.
         </para>
     </section>