File: botch-graph2text.pod

package info (click to toggle)
botch 0.24-6
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 1,084,624 kB
  • sloc: xml: 11,924,892; ml: 4,489; python: 3,890; sh: 1,268; makefile: 334
file content (95 lines) | stat: -rw-r--r-- 3,122 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
=head1 NAME

botch-graph2text - for each vertex in a graph print a formatted line on standard output

=head1 SYNOPSIS

=over

=item B<botch-graph2text> [options] [I<ingraph>] formatstring

=back

=head1 DESCRIPTION

Given a B<formatstring> of the form C<{attr1} {attr2}...>, print a line with
this format for every vertex in the graph, replacing C<{attr}> placeholders
with the value of the attribute C<"attr"> for that vertex. If no attribute with
name C<"attr"> was found, then the placeholder C<{XXX}> remains in the output
string. To write a literal opening or closing curly brace, type them twice,
respectively.  The special placeholder C<{__ID__}> is replaced with the vertex
identifier.

If the positional arguments is omitted, then read GraphML or dot from standard
input.  Passing a '-' as either argument, explicitly specifies to read the
input from standard input. The input graph type will be determined
automatically.

=head1 OPTIONS

=over 4

=item B<-h, --help>

Display help.

=item B<--vertex=>I<VERT>

This option picks the set of vertices that will be output. The VERT argument is
a key/value pair (separated by a colon) of a graph attribute and its value. By
default (without this option), all vertices of the graph are considered.

The special key C<__ID__> allows one to select the unique vertex identifier.

This option can be specified more than once. The final set of vertices is
chosen such that all vertices match all key/value pairs. Multiple B<--vertex>
options thus form a logical conjunction (they are AND-ed together).

=item B<-v, --verbose>

Be verbose.

=back

=head1 EXAMPLE

Find all source packages that build depend on C<texlive-binaries:amd64 (=2015.20150524.37493-5)>.

Using package selection and reverse dependency cone computation by ceve:

	dose-ceve -r "texlive-binaries:amd64 (= 2015.20150524.37493-5)" --deb-native-arch=amd64 -G pkg -T grml deb://Packages debsrc://Sources \
		| botch-graph-sources - - \
		| botch-graph2text - "{realpackage} (= {realversion})" --vertex type:src \
		| sort

Using package selection and ancestor vertex computation by botch:

	dose-ceve --deb-native-arch=amd64 -G pkg -T grml deb://Packages debsrc://Sources \
		| botch-graph-ancestors - - --target realpackage:texlive-binaries:amd64 realversion:2015.20150524.37493-5 \
		| botch-graph-sources - - \
		| botch-graph2text - "{realpackage} (= {realversion})" --vertex type:src \
		| sort

=head1 BUGS

See L<http://bugs.debian.org/botch>.

=head1 SEE ALSO

Debian doc-base Manual F</usr/share/doc/botch/wiki/Home.html>

=head1 AUTHOR

This man page was written by Johannes Schauer. Botch is written by Johannes
Schauer and Pietro Abate.

=head1 COPYRIGHT

Copyright 2012-2014 Johannes Schauer, Pietro Abate

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU Lesser General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your option) any
later version. A special linking exception to the GNU Lesser General Public
License applies to this library, see the COPYING file for more information.