=pod

=head1 NAME

Graph-Dependency - Generate dependency graphs for a Perl package.

=head1 INSTALLATION

To install this module type the following:

  perl Makefile.PL
  make
  make test

=head1 REQUIRES

You need the following:

       Perl                    (well, duh!)
       wget                    (to acceess search.cpan.org)
       Module::CoreList
       Graph::Easy             (for the graphs)
       graphviz                (for png output)

=head1 USAGES

       ./graph YAML
       ./graph Graph::Easy html
       ./graph Graph::Easy png svg html

The output will be written to C<out/Foo-Bar/>. The META.yml
file for each module will be written to C<tmp/>.

=head1 BUGS

=over 10

=item *

The META.yml files are cached, but there is no mechanism to invalidate
or re-validate them. If you want to refresh the data, delete everything
in C<tmp/>.

=item *

Modules without a META.yml file will not generate dependencies. Parsing
of Makefile.PL is not implemented yet.

=item *

Modules that are in the core of I<any> Perl version are marked as "in-core".
If you have an older Perl, you might still need to install that module
first to satisfy the dependencies.

=item *

Getting the author name from the package requires a needless trip to
L<http://search.cpan.org> and might even fail. It would be cool
(I<*wink*> I<*nudge*>) if search.cpan.org could redirect to the proper
file when given:

       http://search.cpan.org/src/FOO-BAR/META.yml

=back

=head1 COPYRIGHT AND LICENCE

Copyright (C) 2006 by Tels at bloodgate.com

This library is free software; you can redistribute it and/or modify
it under the same terms of the GPL version 2.