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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | SEE ALSO | AUTHOR

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

home | help