Debian Codegraph @

doc/man/botch-graph-sources.pod

raw
1 =head1 NAME
2
3 botch-graph-sources - find all sources (vertices without predecessors) in a graph in GraphML or dot format
4
5 =head1 SYNOPSIS
6
7 =over
8
9 =item B<botch-graph-sources> [options] [I<ingraph>] [I<outgraph>]
10
11 =back
12
13 =head1 DESCRIPTION
14
15 Extract the subgraph of all sources (vertices without predecessors) in the
16 input graph.
17
18 If either (or both) of the positional arguments is/are omitted, then read
19 GraphML or dot from standard input and/or write GraphML or dot to standard
20 output, respectively. Passing a '-' as either argument, explicitly specifies
21 to read the input from standard input and write the output to standard output,
22 respectively.
23
24 The input graph type will be determined automatically. If the output graph is
25 given as a filename, then the output type will be GraphML if the filename ends
26 with .xml and dot if the filename ends with .dot. If the output is done on
27 standard output then it will happen in the same format as the input graph.
28
29 =head1 OPTIONS
30
31 =over 4
32
33 =item B<-h, --help>
34
35 Display help.
36
37 =item B<-v, --verbose>
38
39 Be verbose.
40
41 =back
42
43 =head1 EXAMPLE
44
45 Find all source packages that build depend on C<texlive-binaries:amd64 (=2015.20150524.37493-5)>.
46
47 Using package selection and reverse dependency cone computation by ceve:
48
49 dose-ceve -r "texlive-binaries:amd64 (= 2015.20150524.37493-5)" --deb-native-arch=amd64 -G pkg -T grml deb://Packages debsrc://Sources \
50 | botch-graph-sources - - \
51 | botch-graph2text - "{realpackage} (= {realversion})" --vertex type:src \
52 | sort
53
54 Using package selection and ancestor vertex computation by botch:
55
56 dose-ceve --deb-native-arch=amd64 -G pkg -T grml deb://Packages debsrc://Sources \
57 | botch-graph-ancestors - - --target realpackage:texlive-binaries:amd64 realversion:2015.20150524.37493-5 \
58 | botch-graph-sources - - \
59 | botch-graph2text - "{realpackage} (= {realversion})" --vertex type:src \
60 | sort
61
62 =head1 BUGS
63
64 See L<http://bugs.debian.org/botch>.
65
66 =head1 SEE ALSO
67
68 Debian doc-base Manual F</usr/share/doc/botch/wiki/Home.html>
69
70 =head1 AUTHOR
71
72 This man page was written by Johannes Schauer. Botch is written by Johannes
73 Schauer and Pietro Abate.
74
75 =head1 COPYRIGHT
76
77 Copyright 2012-2014 Johannes Schauer, Pietro Abate
78
79 This program is free software: you can redistribute it and/or modify it under
80 the terms of the GNU Lesser General Public License as published by the Free
81 Software Foundation, either version 3 of the License, or (at your option) any
82 later version. A special linking exception to the GNU Lesser General Public
83 License applies to this library, see the COPYING file for more information.
84