Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
prune(1)		     General Commands Manual			prune(1)

NAME
     prune - Prune directed graphs

SYNOPSIS
     prune [ -n node ] [ -N attrspec ] [ -v ] [ -(h|?)	] [ files ...  ]

DESCRIPTION
     prune  reads  directed graphs in the same format used by dot(1) and removes
     subgraphs rooted at nodes specified on the command line via options.  These
     nodes  themselves	will not be removed, but can be given attributes so that
     they can be easily located by a graph stream editor such as gvpr(1).  prune
     correctly handles cycles, loops and multi-edges.

     Both options can appear multiple times on the command line.  All  subgraphs
     rooted at the respective nodes given will then be processed. If a node does
     not  exist,  prune  will skip it and print a warning message to stderr.  If
     multiple attributes are given, they will be applied to all nodes that  have
     been processed.  prune writes the result to the stdout.

OPTIONS
     -n name
	    Specifies name of node to prune.

     -N attrspec
	    Specifies  attribute  that will be set (or changed if it exists) for
	    any pruned node.  attrspec is a string of the form attr=value.

     -v     Verbose output.

     -h -?  Prints the usage and exits.

EXAMPLES
     An input graph test.gv of the form

	  digraph DG {
	    A -> B;
	    A -> C;

	    B -> D;
	    B -> E;
	  }

     , processed by the command

	  prune -n B test.gv

     would produce the following output (the actual code might be formatted in a
     slightly different way).

	  digraph DG {
	    A -> B;
	    A -> C;
	  }

     Another input graph test.gv of the form

	  digraph DG {
	    A -> B;
	    A -> C;

	    B -> D;
	    B -> E;

	    C -> E;
	  }

     (note the additional edge from C to E ), processed by the command

	  prune -n B -N color=red test.gv

     results in

	  digraph DG {
	    B [color=red];
	    A -> B;
	    A -> C;
	    C -> E;
	  }

     Node E has not been removed since its second parent C is not being pruned.

EXIT STATUS
     prune returns 0 on successful completion.	It returns 1 if an error occurs.

SEE ALSO
     dot(1), gvpr(1)

AUTHOR
     Marcus Harnisch <marcus.harnisch@gmx.net>

									prune(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=prune&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help