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
|
.\" Hey, EMACS: -*- nroff -*-
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH PRCS-VISUALTREE SECTION "2001-10-28"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
prcs_tree_info prcs_tree_draw \- utilities for visualizing PRCS trees as
graphs
.SH SYNOPSIS
.B prcs info -l
.RI [ project ]
.B | prcs_tree_info | xvcg
.br
.B prcs_tree_draw
.RI " project"
.br
.SH DESCRIPTION
This manual page documents briefly the
.B prcs-visualtree
suite.
This manual page was written for the Debian GNU/Linux distribution
because the original programs do not have a manual page.
.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
.\" respectively.
\fBprcs_tree\fP and \fBprcs_tree2\fP read the output from "prcs info
-l project" and plot the relationship between versions. Output is commands
for "VCG tool - visualization of compiler graphs" by Iris Lemke, Georg
Sander, and the Compare Consortium.
.PP
It is possible to use different branches to check how they depend
on each other. This example assumes a couple of branches starting
with 'EDS', a couple of branches starting with 'HC', asks info
and feeds the output to xvcg. Versions that are merged into the
'EDS*' or 'HC*', have a single node to show this, but don't have
any node information.
.PP
.Vb 3
\& ( prcs info -l --plain-format -r "EDS*" genesis.prj \\
\& && prcs info -l --plain-format -r "HC*" genesis.prj ) \\
\& | prcs_tree_info | xvcg -
.Ve
The info1 field of the nodes is used for the version logs.
Perhaps the info2 field could be used for date.
.PP
\fBprcs_tree_draw\fP is a quick and dirty shell script which takes a
project name, optional start and end version numbers, extracts the prcs
info -l data, runs prcs_tree and calls xvcg on the result.
.SH SEE ALSO
.BR prcs (1),
.BR xvcg (1).
.br
.SH AUTHOR
This manual page was written by Rafael Laboissiere <rafael@debian.org>,
for the Debian GNU/Linux system (but may be used by others).
|
