Debian Codegraph @

doc/man/botch-graph2text.pod

raw
1 =head1 NAME
2
3 botch-graph2text - for each vertex in a graph print a formatted line on standard output
4
5 =head1 SYNOPSIS
6
7 =over
8
9 =item B<botch-graph2text> [options] [I<ingraph>] formatstring
10
11 =back
12
13 =head1 DESCRIPTION
14
15 Given a B<formatstring> of the form C<{attr1} {attr2}...>, print a line with
16 this format for every vertex in the graph, replacing C<{attr}> placeholders
17 with the value of the attribute C<"attr"> for that vertex. If no attribute with
18 name C<"attr"> was found, then the placeholder C<{XXX}> remains in the output
19 string. To write a literal opening or closing curly brace, type them twice,
20 respectively. The special placeholder C<{__ID__}> is replaced with the vertex
21 identifier.
22
23 If the positional arguments is omitted, then read GraphML or dot from standard
24 input. Passing a '-' as either argument, explicitly specifies to read the
25 input from standard input. The input graph type will be determined
26 automatically.
27
28 =head1 OPTIONS
29
30 =over 4
31
32 =item B<-h, --help>
33
34 Display help.
35
36 =item B<--vertex=>I<VERT>
37
38 This option picks the set of vertices that will be output. The VERT argument is
39 a key/value pair (separated by a colon) of a graph attribute and its value. By
40 default (without this option), all vertices of the graph are considered.
41
42 The special key C<__ID__> allows one to select the unique vertex identifier.
43
44 This option can be specified more than once. The final set of vertices is
45 chosen such that all vertices match all key/value pairs. Multiple B<--vertex>
46 options thus form a logical conjunction (they are AND-ed together).
47
48 =item B<-v, --verbose>
49
50 Be verbose.
51
52 =back
53
54 =head1 EXAMPLE
55
56 Find all source packages that build depend on C<texlive-binaries:amd64 (=2015.20150524.37493-5)>.
57
58 Using package selection and reverse dependency cone computation by ceve:
59
60 dose-ceve -r "texlive-binaries:amd64 (= 2015.20150524.37493-5)" --deb-native-arch=amd64 -G pkg -T grml deb://Packages debsrc://Sources \
61 | botch-graph-sources - - \
62 | botch-graph2text - "{realpackage} (= {realversion})" --vertex type:src \
63 | sort
64
65 Using package selection and ancestor vertex computation by botch:
66
67 dose-ceve --deb-native-arch=amd64 -G pkg -T grml deb://Packages debsrc://Sources \
68 | botch-graph-ancestors - - --target realpackage:texlive-binaries:amd64 realversion:2015.20150524.37493-5 \
69 | botch-graph-sources - - \
70 | botch-graph2text - "{realpackage} (= {realversion})" --vertex type:src \
71 | sort
72
73 =head1 BUGS
74
75 See L<http://bugs.debian.org/botch>.
76
77 =head1 SEE ALSO
78
79 Debian doc-base Manual F</usr/share/doc/botch/wiki/Home.html>
80
81 =head1 AUTHOR
82
83 This man page was written by Johannes Schauer. Botch is written by Johannes
84 Schauer and Pietro Abate.
85
86 =head1 COPYRIGHT
87
88 Copyright 2012-2014 Johannes Schauer, Pietro Abate
89
90 This program is free software: you can redistribute it and/or modify it under
91 the terms of the GNU Lesser General Public License as published by the Free
92 Software Foundation, either version 3 of the License, or (at your option) any
93 later version. A special linking exception to the GNU Lesser General Public
94 License applies to this library, see the COPYING file for more information.
95