prcs_tree_info prcs_tree_draw - utilities for visualizing PRCS trees as graphs

prcs info -l [project] | prcs_tree_info | xvcg -

prcs_tree_draw project

prcs-show-tree [[-r<rev-pattern>]...] [-ps<filename>] [args]

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 -

prcs_tree_draw 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.

The prcs-show-tree is a more elaborated script that just runs prcs_tree_info as shown above, avoiding the cumbersome command-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 Encapsulated 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.

prcs(1), xvcg(1).

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).