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

FreeBSD Manual Pages

  
 
  

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 re-
       moves subgraphs rooted at nodes specified on the	command	line  via  op-
       tions. These nodes themselves will not be removed, but can be given at-
       tributes	 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 sub-
       graphs 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 oc-
       curs.

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+14.3.quarterly>

home | help