diff options
author | Lars Wirzenius <lars.wirzenius@codethink.co.uk> | 2013-07-04 13:12:16 +0000 |
---|---|---|
committer | Lars Wirzenius <lars.wirzenius@codethink.co.uk> | 2013-07-05 14:35:46 +0000 |
commit | 53358c2d1ae4a96cadc9a5a388bbafa7549b633a (patch) | |
tree | b28f41c798a64caede5f972265b78fcb073e40ca /morphlib/plugins/graphing_plugin.py | |
parent | fa5ba79319d4cfd47cb5f6176d01dbddfeff1466 (diff) | |
download | morph-53358c2d1ae4a96cadc9a5a388bbafa7549b633a.tar.gz |
Improve docstring for "morph graph-build-depends"
Diffstat (limited to 'morphlib/plugins/graphing_plugin.py')
-rw-r--r-- | morphlib/plugins/graphing_plugin.py | 30 |
1 files changed, 29 insertions, 1 deletions
diff --git a/morphlib/plugins/graphing_plugin.py b/morphlib/plugins/graphing_plugin.py index 8c4ea2ef..75514eec 100644 --- a/morphlib/plugins/graphing_plugin.py +++ b/morphlib/plugins/graphing_plugin.py @@ -31,7 +31,35 @@ class GraphingPlugin(cliapp.Plugin): pass def graph_build_depends(self, args): - '''Create a visualisation of build dependencies in a stratum''' + '''Create a visualisation of build dependencies in a system. + + Command line arguments: + + * `REPO` is a repository URL. + * `REF` is a git reference (usually branch name). + * `MORPHOLOGY` is a system morphology. + + This produces a GraphViz DOT file representing all the build + dependencies within a system, based on information in the + morphologies. The GraphViz `dot` program can then be used to + create a graphical representation of the dependencies. This + can be helpful for inspecting whether there are any problems in + the dependencies. + + Example: + + morph graph-build-depends baserock:baserock/morphs master \ + devel-system-x86_64-generic > foo.dot + dot -Tpng foo.dot > foo.png + + The above would create a picture with the build dependencies of + everything in the development system for 64-bit Intel systems. + + GraphViz is not, currently, part of Baserock, so you need to run + `dot` on another system. + + ''' + for repo_name, ref, filename in self.app.itertriplets(args): self.app.status(msg='Creating build order for ' '%(repo_name)s %(ref)s %(filename)s', |