#
# $Id: pkg_tree.pod,v 1.1 2001/12/12 11:38:47 mavetju Exp $
#

=head1 NAME

B<pkg_tree> - Generate a graphical tree of packages and their dependencies

=head1 SYNOPSIS

B<pkg_tree> [B<-v>] [I<package-prefix ...>]

=head1 DESCRIPTION

This program generates a graphical tree of packages and their
dependancies.

=head1 USAGE

To show the dependencies of all packages, run it without arguments:

[~] edwin@k7E<gt>B<pkg_tree>

To show the dependencies of one package, run it with an argument:

E<32>[~] edwin@k7E<gt>B<pkg_tree linux-netscape>
 linux-netscape-navigator-4.79
 |\__ netscape-remote-1.0_1
 |\__ netscape-wrapper-2000.07.07
 |\__ linux_base-6.1
 |\__ imake-4.1.0 (unknown)
 |\__ freetype2-2.0.5
  \__ XFree86-libraries-4.1.0 (unknown)

To also show the dependencies of the dependencies, use the B<-v> parameter:

E<32>[~] edwin@k7E<gt>B<pkg_tree -v linux-netscape>
 linux-netscape-navigator-4.79
 |\__ netscape-remote-1.0_1
 |     |\__ imake-4.1.0 (unknown)
 |     |\__ freetype2-2.0.3 (unknown)
 |      \__ XFree86-libraries-4.1.0 (unknown)
 |\__ netscape-wrapper-2000.07.07
 |     |\__ freetype2-2.0.3 (unknown)
 |     |\__ imake-4.1.0 (unknown)
 |     |\__ netscape-remote-1.0_1
 |     |     |\__ imake-4.1.0 (unknown)
 |     |     |\__ freetype2-2.0.3 (unknown)
 |     |      \__ XFree86-libraries-4.1.0 (unknown)
 |      \__ XFree86-libraries-4.1.0 (unknown)
 |\__ linux_base-6.1
 |\__ imake-4.1.0 (unknown)
 |\__ freetype2-2.0.5
  \__ XFree86-libraries-4.1.0 (unknown)

Use the B<-t> parameter to show only top level packages,
and B<-b> to show only bottom level packages. And B<-t> B<-q>
together will give the list of top level packages without their
dependencies, installing only these packages should install all
currently installed packages.

=head1 RETURN VALUES

Always 0.

=head1 BUGS

Ports which have upgraded ports in their dependencies don't show
their dependencies anymore if the old port is deleted; it then
prints "(unknown)".

=head1 AUTHOR

Edwin Groothuis, edwin@mavetju.org (http://www.mavetju.org)

=head1 SEE ALSO

ports(7)