prune

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)