Debian Codegraph @

doc/man/botch-multiarch-interpreter-problem.pod

raw
1 =head1 NAME
2
3 botch-multiarch-interpreter-problem - find all arch:all packages that allow switching architectures
4
5 =head1 SYNOPSIS
6
7 =over
8
9 =item B<botch-multiarch-interpreter-problem> [-h] [-v] graph.xml
10
11 =back
12
13 =head1 DESCRIPTION
14
15 Given a package graph, this program outputs a page in plain text format listing
16 all Architecture:all and not Multi-Arch:foreign packages that are on a
17 dependency path between two Architecture:any packages.
18
19 More precisely, dose-ceve creates a graph with binary packages and source
20 packages being the nodes and their dependency and provides relationship being
21 the edges. This program prints all nodes (or packages) that fulfill the
22 following criteria:
23
24 =over 4
25
26 =item the package is not Multi-Arch:foreign
27
28 =item the package is Architecture:all
29
30 =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
31
32 =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.
33
34 =back
35
36 =head1 OPTIONS
37
38 =over 4
39
40 =item B<-v, --verbose>
41
42 Be verbose.
43
44 =item B<-h, --help>
45
46 Print help message.
47
48 =item B<--packages>
49
50 Packages file to retrieve binary package size
51
52 =item B<-H, --html>
53
54 Output HTML document with additional statistics
55
56 =back
57
58 =head1 EXAMPLE
59
60 The graph created by dose-ceve must not contains Build-Depends-Indep
61 dependencies because source packages do not have to be cross-built to create
62 their Architecture:all packages. These can always be retrieved by native
63 compilation. The graph does not have to include builds-from relationships
64 because the Architecture field of source packages is used to determine whether
65 a source package builds Architecture:any binary packages.
66
67 dose-ceve --deb-drop-b-d-indep --deb-native-arch=amd64 -G pkg -T grml deb://Packages.gz debsrc://Sources.gz > graph.xml
68 botch-multiarch-interpreter-problem --packages=Packages.gz graph.xml > out.html
69 w3m out.html
70
71 =head1 BUGS
72
73 See L<http://bugs.debian.org/botch>.
74
75 =head1 SEE ALSO
76
77 Debian doc-base Manual F</usr/share/doc/botch/wiki/Home.html>
78
79 =head1 AUTHOR
80
81 This man page was written by Johannes Schauer. Botch is written by Johannes
82 Schauer and Pietro Abate.
83
84 =head1 COPYRIGHT
85
86 Copyright 2012-2014 Johannes Schauer, Pietro Abate
87
88 This program is free software: you can redistribute it and/or modify it under
89 the terms of the GNU Lesser General Public License as published by the Free
90 Software Foundation, either version 3 of the License, or (at your option) any
91 later version. A special linking exception to the GNU Lesser General Public
92 License applies to this library, see the COPYING file for more information.
93