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)
