NAME

perl_graph_usage - generate graph with usage patterns from Perl packages

SYNOPSIS

./gen_graph --inc=lib/ --format=graphviz --output=usage_graph
./gen_graph --nocolor --inc=lib --format=ascii
./gen_graph --recurse=Graph::Easy

Options:

--color=X		0: uncolored output
			1: default, colorize nodes on how much packages they use
			2: colorize nodes on how much packages use them
--nocolor		sets color to 0 (like --color=0, no color at all)
--inc=path[,path2,..]	path to source tree or a single file
			if not specified, @INC from Perl will be used
--recurse=p[,p2,..]	recursively track all packages from package "p"
--format		the output format, default "graphviz", valid are:
			  ascii
			  html
			  graphviz
			  svg
			For the latter two formats you need "dot" installed
--output		name of the output file, default "usage". The file
			extension will be determined by the --format option.
--versions		include package version number in graph nodes.
--debug			print some timing and statistics info.

Help and version:

--help			print this help and exit
--version		print version and exit

DESCRIPTION

Todo

Output formats

html and ascii are rendered via Graph::Easy. The have thus quite a few limitations and only work good for simple graphs. svg and graphviz are rendered via dot and can have arbitrary large graphs.

However, for entire source trees like the complete Perl source, the output becomes unlegible and cramped.

I hope I can improve this in time.

LICENSE

AUTHOR

(c) 2005 by Tels bloodgate.com.