# This is dot2term, a program that converts graphs expressed in 'dot'
# format, into the 'term representation' that can be handled by
# uDrawGraph.
# 
# WHY
# 
# The quattor tool 'panc-call-tree.pl' can output the include tree of a
# quattor machine profile; the supported formats are 'dot' and
# 'hypergraph'.  'dot' can be read by Graphviz [1] and 'hypergraph' can
# be read by Hypergraph [2].  Neither of these tools allow for easy
# navigation of the graphs, nor (especially important to me) hiding
# various pieces of the subgraph, in order to be able to view the
# interesting part at a reasonable scale.  The uDrawGraph [3] program
# does allow such manipulations of the displayed graphs.
# 
# WHAT
# 
# * run the pan compiler on your favorite template with logging mode on.  At Nikhef
#   the relevant command is
#     makexprof -l call -f <cluster> <hostname>
# 
# * run panc-call-tree.pl; at Nikhef the relevant command is
#     panc-call-tree.pl $L/build/log/panc.log
#   This will yield a file <hostname>.dot in the current working directory
# 
# * run dot2term
#     dot2term <hostname>.dot
#   This will yield a filename <hostname>.udg if the input file ended in '.dot';
#   otherwise the output file will be called <inputfilename>.udg
# 
# LIMITATIONS
# 
# The 'dot' language includes many features; I only dealt with converting those encountered
# in the output of panc-call-tree.pl.  There are probably many dot files which cannot be
# converted with this tool.
#
# [1] http://www.graphviz.org/
# [2] http://hypergraph.sourceforge.net/
# [3] http://www.informatik.uni-bremen.de/uDrawGraph/en/uDrawGraph/uDrawGraph.html