[oe-commits] [bitbake] 01/02: bitbake-user-manual: Rewrite dependency dot file generation

[git at git.openembedded.org]

This is an automated email from the git hooks/post-receive script.

rpurdie pushed a commit to branch master
in repository bitbake.

commit f82537d27f2a5bf9d576aa841593db9ec0985ea8
Author: Scott Rifenbark <srifenbark at gmail.com>
AuthorDate: Mon Jan 23 15:44:19 2017 -0800

    bitbake-user-manual: Rewrite dependency dot file generation
    
    The package-depends.dot and pn-depends.dot files are inaccurate,
    missing out key dependencies such those made via the [depends]
    flags. As such they can be misleading to the user.
    
    They mainly exist for historical reasons, coming from a time
    before we had task based execution.
    
    This commit removes the two dated file formats and replaces
    them with a recipe-depends.dot which is a flattened version
    of task-depends.dot.
    
    The old format files are removed if present so that the user
    can't get confused about why data might not match between files.
    
    The code is also rewritten to use 'with f: f.write()' syntax as
    is more commonly used now. Also update the docs to match the change.
    
    Signed-off-by: Richard Purdie <richard.purdie at linuxfoundation.org>
---
 doc/bitbake-user-manual/bitbake-user-manual-intro.xml | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/doc/bitbake-user-manual/bitbake-user-manual-intro.xml b/doc/bitbake-user-manual/bitbake-user-manual-intro.xml
index daf5b35..7248a0b 100644
--- a/doc/bitbake-user-manual/bitbake-user-manual-intro.xml
+++ b/doc/bitbake-user-manual/bitbake-user-manual-intro.xml
@@ -669,13 +669,18 @@
                     When you generate a dependency graph, BitBake writes three files
                     to the current working directory:
                     <itemizedlist>
-                        <listitem><para><emphasis><filename>recipe-depends.dot</filename>:</emphasis>
-                            Shows dependencies between recipes (a collapsed version of task-depends.dot).
+                        <listitem><para>
+                            <emphasis><filename>recipe-depends.dot</filename>:</emphasis>
+                            Shows dependencies between recipes (i.e. a collapsed version of
+                            <filename>task-depends.dot</filename>).
                             </para></listitem>
-                        <listitem><para><emphasis><filename>task-depends.dot</filename>:</emphasis>
-                            Shows dependencies between tasks. This matches bitbake's internal task execution list.
+                        <listitem><para>
+                            <emphasis><filename>task-depends.dot</filename>:</emphasis>
+                            Shows dependencies between tasks.
+                            These dependencies match BitBake's internal task execution list.
                             </para></listitem>
-                        <listitem><para><emphasis><filename>pn-buildlist</filename>:</emphasis>
+                        <listitem><para>
+                            <emphasis><filename>pn-buildlist</filename>:</emphasis>
                             Shows a simple list of targets that are to be built.
                             </para></listitem>
                     </itemizedlist>

-- 
To stop receiving notification emails like this one, please contact
the administrator of this repository.