mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-05-30 12:29:55 +00:00
Code Issues Projects Releases Wiki Activity

ref-manual: Applied review edits to "Viewing Dependencies"

Browse Source 
Fixes [YOCTO #10131]

Fixed some small issues here and there.  Also, provided a
second itemized item in the note box turning it into a
notes box.

(From yocto-docs rev: a736c3bb707e81eda7760c642084a5a7c4de2539)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark
2016-08-12 14:47:13 -07:00
committed by Richard Purdie
parent b249c8d2d5
commit f1d2a932f6
1 changed files with 39 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/ref-manual/usingpoky.xml
+39 -25
View File
@@ -253,7 +253,8 @@
<para> <para>
Sometimes it can be hard to see why BitBake wants to build other Sometimes it can be hard to see why BitBake wants to build other
recipes before the one you have specified. recipes before the one you have specified.
Dependency information can help you understand recipe build order. Dependency information can help you understand why a recipe is
built.
</para> </para>
<para> <para>
@@ -293,32 +294,45 @@
<para> <para>
The graphs are in The graphs are in
<ulink url='https://en.wikipedia.org/wiki/DOT_%28graph_description_language%29'>DOT</ulink> <ulink url='https://en.wikipedia.org/wiki/DOT_%28graph_description_language%29'>DOT</ulink>
format and can be converted to images (e.g. using the "dot" tool format and can be converted to images (e.g. using the
from <filename>dot</filename> tool from
<ulink url='http://www.graphviz.org/'>Graphviz</ulink>. <ulink url='http://www.graphviz.org/'>Graphviz</ulink>).
<note> <note><title>Notes</title>
<para>DOT files use a plain text format. <itemizedlist>
The graphs generated using the <listitem><para>
<filename>bitbake -g</filename> command are often so large as DOT files use a plain text format.
to be impossible to read without special pruning (e.g. with The graphs generated using the
Bitbake's <filename>-I</filename> option) and processing. <filename>bitbake -g</filename> command are often so
Despite the form and size of the files, the corresponding large as to be difficult to read without special
<filename>.dot</filename> files can still be easy to read pruning (e.g. with Bitbake's
and provide useful information.</para> <filename>-I</filename> option) and processing.
Despite the form and size of the graphs, the
corresponding <filename>.dot</filename> files can still
be possible to read and provide useful information.
</para>
<para>As an example, the <para>As an example, the
<filename>task-depends.dot</filename> file contains lines such <filename>task-depends.dot</filename> file contains
as the following: lines such as the following:
<literallayout class='monospaced'> <literallayout class='monospaced'>
"libxslt.do_configure" -> "libxml2.do_populate_sysroot" "libxslt.do_configure" -> "libxml2.do_populate_sysroot"
</literallayout> </literallayout>
The above example line reveals that the The above example line reveals that the
<link linkend='ref-tasks-configure'><filename>do_configure</filename></link> <link linkend='ref-tasks-configure'><filename>do_configure</filename></link>
task in <filename>libxslt</filename> depends on the task in <filename>libxslt</filename> depends on the
<link linkend='ref-tasks-populate_sysroot'><filename>do_populate_sysroot</filename></link> <link linkend='ref-tasks-populate_sysroot'><filename>do_populate_sysroot</filename></link>
task in <filename>libxml2</filename>, which is a normal task in <filename>libxml2</filename>, which is a normal
<link linkend='var-DEPENDS'><filename>DEPENDS</filename></link> <link linkend='var-DEPENDS'><filename>DEPENDS</filename></link>
dependency between the two recipes.</para> dependency between the two recipes.
</para></listitem>
<listitem><para>
For an example of how <filename>.dot</filename> files
can be processed, see the
<filename>scripts/contrib/graph-tool</filename> Python
script, which finds and displays paths between graph
nodes.
</para></listitem>
</itemizedlist>
</note> </note>
</para> </para>