prcs-visualtree(1)

NAME

prcs_tree_info prcs_tree_draw - utilities for visualizing

PRCS trees as graphs

SYNOPSIS

prcs info -l [project] | prcs_tree_info | xvcg prcs_tree_draw  project
prcs-show-tree   [[-r<rev-pattern>]...]    [-ps<filename>]
[args]

DESCRIPTION

This manual page documents briefly the prcs-visualtree

suite. This manual page was written for the Debian GNU/Linux

distribution because the original programs do not have a manual

page.

prcs_tree and prcs_tree2 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.

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 any node information.

( prcs info -l --plain-format -r "EDS*" genesis.prj

&& prcs info -l --plain-format -r "HC*" genesis.prj )

| prcs_tree_info | xvcg

The info1 field of the nodes is used for the version logs.

Perhaps the info2 field could be used for date.

prcs_tree_draw is a quick and dirty shell script which

takes a project name, optional start and end version numbers, ex

tracts the prcs info -l data, runs prcs_tree and calls xvcg on

the result.

The prcs-show-tree is a more elaborated script that just

runs prcs_tree_info as shown above, avoiding the cumbersome com

mand-line which is quite annoying to enter.

Without leading -r options, it graphs the full project.

With -r options, it only graphs the branches whose names match

the given patterns.

Use the -ps option to output the graph directly to an En

capsulated PostScript file, instead of calling xvcg to display

the revision tree.

"args" are additional args to pass to "prcs -l" if needed.

Typically this can be a project name. "-r" options should not be

specified there.

SEE ALSO

prcs(1), xvcg(1).

AUTHOR

Keith Owens <kaos@ocs.com.au> wrote the prcs_tree*

scripts.

Yann Dirson <dirson@debian.org> contributed the prcs-show

tree script.

This manual page was written by Rafael Laboissiere

<rafael@debian.org>, for the Debian GNU/Linux system (but may be

used by others).

2001-10-28 PRCS

VISUALTREE(1)