import upstream version 0.19

3 files changed, 40 insertions, 10 deletions

diff --git a/doc/man/botch-create-graph.pod b/doc/man/botch-create-graph.pod
index c406bdc..9fd69d4 100644
--- a/doc/man/botch-create-graph.pod
+++ b/doc/man/botch-create-graph.pod
@@ -103,7 +103,7 @@ option drops this requirement.
 Calculate a dependency graph where each installation set contains the minimal
 number of unavailable binary packages.
 
-=item B<--num_cores=>I<NUM>
+=item B<-j, --jobs=>I<NUM>
 
 How many worker processes to run in parallel. Default: 1
 
diff --git a/doc/man/botch-multiarch-interpreter-problem.pod b/doc/man/botch-multiarch-interpreter-problem.pod
index 1f1995b..a49b863 100644
--- a/doc/man/botch-multiarch-interpreter-problem.pod
+++ b/doc/man/botch-multiarch-interpreter-problem.pod
@@ -16,14 +16,22 @@ Given a package graph, this program outputs a page in plain text format listing
 all Architecture:all and not Multi-Arch:foreign packages that are on a
 dependency path between two Architecture:any packages.
 
-More precisely, dose-ceve creates a graph with binary packages being the nodes
-and their dependency and provides relationship being the edges. This page
-prints all nodes that have a (possibly transitive) predecessor (a reverse
-dependency) that is not Architecture:all and that have a (possibly transitive)
-successor (a dependency) that is not Architecture:all and not
-Multi-Arch:foreign. If a Multi-Arch:foreign package is encountered while
-walking the successors, then the successors of that package are not further
-traversed.
+More precisely, dose-ceve creates a graph with binary packages and source
+packages being the nodes and their dependency and provides relationship being
+the edges. This program prints all nodes (or packages) that fulfill the
+following criteria:
+
+=over 4
+
+=item the package is not Multi-Arch:foreign
+
+=item the package is Architecture:all
+
+=item the package has a (possibly transitive) predecessor in the dependency graph that is either an Architecture:any binary package or a source package that builds Architecture:any packages
+
+=item the package has a (possibly transitive) successor in the dependency graph that is Architecture:any and not Multi-Arch:foreign. Traversal of the successors stops at Multi-Arch:foreign packages.
+
+=back
 
 =head1 OPTIONS
 
@@ -49,7 +57,14 @@ Output HTML document with additional statistics
 
 =head1 EXAMPLE
 
- dose-ceve -G pkg -T grml -t deb Packages.gz > graph.xml
+The graph created by dose-ceve must not contains Build-Depends-Indep
+dependencies because source packages do not have to be cross-built to create
+their Architecture:all packages. These can always be retrieved by native
+compilation. The graph does not have to include builds-from relationships
+because the Architecture field of source packages is used to determine whether
+a source package builds Architecture:any binary packages.
+
+ dose-ceve --deb-drop-b-d-indep --deb-native-arch=amd64 -G pkg -T grml deb://Packages.gz debsrc://Sources.gz > graph.xml
  botch-multiarch-interpreter-problem --packages=Packages.gz graph.xml > out.html
  w3m out.html
 
diff --git a/doc/man/botch-y-u-b-d-transitive-essential.pod b/doc/man/botch-y-u-b-d-transitive-essential.pod
index 39fa88d..ca49c78 100644
--- a/doc/man/botch-y-u-b-d-transitive-essential.pod
+++ b/doc/man/botch-y-u-b-d-transitive-essential.pod
@@ -57,6 +57,21 @@ Execute tools from the source checkout instead of $PATH
 
 =back
 
+=head1 EXAMPLE
+
+To find out why src:sysvinit is b-d-transitive-essential, run:
+
+ botch-y-u-b-d-transitive-essential amd64 Packages Sources sysvinit
+
+Edges from installation sets to source packages (builds-from relationships) can
+be hard to diagnose. You can use dose-ceve to create a graph that doesn't
+condense binary packages to their installation sets. This has the disadvantage
+that also non-strong dependencies are also included.
+
+ dose-ceve -G pkg -T dot --deb-native-arch=amd64 --deb-builds-from --deb-drop-b-d-indep deb://Packages debsrc://Sources > graph.dot
+ botch-graph-shortest-path graph.dot - --source __ID__:"src:build-essential (= 12.2)" --target __ID__:"src:sysvinit (= 2.88dsf-59.8)" > out.dot
+ xdot out.dot
+
 =head1 BUGS
 
 See L<http://bugs.debian.org/botch>.