diff options
| author |   Holger Hans Peter Freyther <zecke@selfish.org> | 2006-05-27 20:30:27 +0000 |
|---|---|---|
| committer | Holger Hans Peter Freyther <zecke@selfish.org> | 2006-05-27 20:30:27 +0000 |
| commit | 5d054be0c2c88791997c5a41de08d4ad17bdf3bb (patch) | |
| tree | 737f9484ade5a9ddb3a94d3b0bd5c32879382bc6 /doc | |
| parent | e15fd00b048820e7aa656dfc9a34a0977fe667d3 (diff) | |
| download | bitbake-5d054be0c2c88791997c5a41de08d4ad17bdf3bb.tar.gz | |
doc/manual/usermanual.xml: Add some Bla about using the -g option
Start documenting the -g option... well start with it. Hopefully
someone else will document it.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/manual/usermanual.xml | 24 |
1 files changed, 21 insertions, 3 deletions
diff --git a/doc/manual/usermanual.xml b/doc/manual/usermanual.xml index eb5eedb19..b0bbd4bd8 100644 --- a/doc/manual/usermanual.xml +++ b/doc/manual/usermanual.xml @@ -345,15 +345,19 @@ options: cannot be remade, the other dependencies of these targets can be processed all the same. -f, --force force run of specified cmd, regardless of stamp status - -i, --interactive drop into the interactive mode. + -i, --interactive drop into the interactive mode also called the BitBake + shell. -c CMD, --cmd=CMD Specify task to execute. Note that this only executes the specified task for the providee and the packages it depends on, i.e. 'compile' does not implicitly call stage for the dependencies (IOW: use only if you know - what you are doing) + what you are doing). Depending on the base.bbclass a + listtaks tasks is defined and will show available + tasks -r FILE, --read=FILE read the specified file before bitbake.conf -v, --verbose output more chit-chat to the terminal - -D, --debug Increase the debug level + -D, --debug Increase the debug level. You can specify this more + than once. -n, --dry-run don't execute, just go through the motions -p, --parse-only quit after parsing the BB files (developers only) -d, --disable-psyco disable using the psyco just-in-time compiler (not @@ -361,6 +365,12 @@ options: -s, --show-versions show current and preferred versions of all packages -e, --environment show the global or per-package environment (this is what used to be bbread) + -g, --graphviz emit the dependency trees of the specified packages in + the dot syntax + -I IGNORED_DOT_DEPS, --ignore-deps=IGNORED_DOT_DEPS + Stop processing at the given list of dependencies when + generating dependency graphs. This can help to make + the graph more appealing </screen> </para> @@ -387,6 +397,14 @@ options: <screen><prompt>$ </prompt>bitbake virtual/whatever</screen> <screen><prompt>$ </prompt>bitbake -c clean virtual/whatever</screen> </example> + <example> + <title>Generating dependency graphs</title> + <para>BitBake is able to generate dependency graphs using the dot syntax. These graphs can be converted +to images using the <application>dot</application> application from <ulink url="http://www.graphviz.org">graphviz</ulink>. +Three files will be written into the current working directory, <emphasis>depends.dot</emphasis> containing <varname>DEPENDS</varname> variables, <emphasis>rdepends.dot</emphasis> containing <varname>RDEPENDS</varname> and <emphasis>alldepends.dot</emphasis> containing all depends. To stop depending on common depends one can use the <prompt>-I depend</prompt> to omit these from the graph. This can lead to more readable graphs.</para> + <screen><prompt>$ </prompt>bitbake -g blah</screen> + <screen><prompt>$ </prompt>bitbake -g -I virtual/whatever -I bloom blah</screen> + </example> </para> </section> <section> |