r46443 - in /branches/upstream/libcpandb-perl/current: Changes META.yml lib/CPANDB.pm script/cpangraph

[jawnsy-guest at users.alioth.debian.org]

Author: jawnsy-guest
Date: Tue Oct 27 02:57:30 2009
New Revision: 46443

URL: http://svn.debian.org/wsvn/pkg-perl/?sc=1&rev=46443
Log:
[svn-upgrade] Integrating new upstream version, libcpandb-perl (0.12)

Modified:
    branches/upstream/libcpandb-perl/current/Changes
    branches/upstream/libcpandb-perl/current/META.yml
    branches/upstream/libcpandb-perl/current/lib/CPANDB.pm
    branches/upstream/libcpandb-perl/current/script/cpangraph

Modified: branches/upstream/libcpandb-perl/current/Changes
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libcpandb-perl/current/Changes?rev=46443&op=diff
==============================================================================
--- branches/upstream/libcpandb-perl/current/Changes (original)
+++ branches/upstream/libcpandb-perl/current/Changes Tue Oct 27 02:57:30 2009
@@ -1,4 +1,7 @@
 Changes for Perl extension CPANDB
+
+0.12
+	- Added documentation for cpangraph (in POD)
 
 0.11 Thu  1 Oct 2009
 	- Updating ORLite::Statistics dependency to 0.03

Modified: branches/upstream/libcpandb-perl/current/META.yml
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libcpandb-perl/current/META.yml?rev=46443&op=diff
==============================================================================
--- branches/upstream/libcpandb-perl/current/META.yml (original)
+++ branches/upstream/libcpandb-perl/current/META.yml Tue Oct 27 02:57:30 2009
@@ -33,4 +33,4 @@
   ChangeLog: http://fisheye2.atlassian.com/changelog/cpan/trunk/CPANDB
   license: http://dev.perl.org/licenses/
   repository: http://svn.ali.as/cpan/trunk/CPANDB
-version: 0.11
+version: 0.12

Modified: branches/upstream/libcpandb-perl/current/lib/CPANDB.pm
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libcpandb-perl/current/lib/CPANDB.pm?rev=46443&op=diff
==============================================================================
--- branches/upstream/libcpandb-perl/current/lib/CPANDB.pm (original)
+++ branches/upstream/libcpandb-perl/current/lib/CPANDB.pm Tue Oct 27 02:57:30 2009
@@ -8,7 +8,7 @@
 use ORLite::Mirror       ();
 use CPANDB::Distribution ();
 
-our $VERSION = '0.11';
+our $VERSION = '0.12';
 
 sub import {
 	my $class  = shift;

Modified: branches/upstream/libcpandb-perl/current/script/cpangraph
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libcpandb-perl/current/script/cpangraph?rev=46443&op=diff
==============================================================================
--- branches/upstream/libcpandb-perl/current/script/cpangraph (original)
+++ branches/upstream/libcpandb-perl/current/script/cpangraph Tue Oct 27 02:57:30 2009
@@ -6,7 +6,16 @@
 use Time::HiRes  ();
 use Getopt::Long ();
 
-our $VERSION = '0.11';
+=head1 NAME
+
+cpangraph - Generate dependency chain graphs for CPAN modules
+
+=head1 VERSION
+
+Version 0.12
+
+=cut
+our $VERSION = '0.12';
 
 use CPANDB ();
 
@@ -16,6 +25,79 @@
 my $VERBOSE = 0;
 my $RANKDIR = 0;
 my $REVERSE = 0;
+
+=head1 SYNOPSIS
+
+  cpangraph [options] <file>
+
+    Options:
+      --help            display a brief help message
+      --perl=VERSION    filter those available in Perl core
+      --phase=PHASE     filter those needed for a phase (e.g., build)
+      --rankdir         controls the GraphViz 'rankdir' variable
+      --reverse         graph reverse dependencies (dependents)
+      --verbose         display additional debugging information
+
+=head1 OPTIONS
+
+=over
+
+=item B<--help>
+
+Prints a brief help message to the standard output and exits.
+
+=item B<--perl>=VERSION
+
+This displays dependencies which have been available in Perl core since
+the given VERSION. It does not currently know if a module has been removed
+from core, but this is an unlikely occurrence. Specify Perl versions in
+the form:
+
+  5.008008 # for versions >= 5.8.8
+  5.010    # for versions >= 5.10
+
+=item B<--phase>=PHASE
+
+This displays dependencies which are needed for a given module's install
+or runtime PHASE. Available phases are:
+
+=over
+
+=item * runtime: required whenever the module is used
+
+=item * build: required to build the module
+
+=item * configure: these are required while preparing the module for
+build
+
+=back
+
+=item B<--rankdir>
+
+In GraphViz, the 'rankdir' attribute controls the direction that the nodes
+are linked together. If set, the graph will use left -> right linking of
+nodes rather than the default up-down linking.
+
+=item B<--reverse>
+
+Create a graph of the reverse dependencies of a package (the packages which
+depend on it, or dependent packages).
+
+=item B<--verbose>
+
+Display extra output useful during debugging.
+
+=back
+
+=cut
+
+=head1 DESCRIPTION
+
+B<This script> will use the CPAN Database to build a graph of a package's
+dependencies or reverse dependencies (dependent packages).
+
+=cut
+
 Getopt::Long::GetOptions(
 	'perl=s'  => \$PERL,
 	'phase=s' => \$PHASE,
@@ -55,3 +137,18 @@
 	phase   => $PHASE,
 	rankdir => $RANKDIR,
 )->as_svg("$file.svg");
+
+=head1 AUTHOR
+
+Adam Kennedy E<lt>adamk at cpan.orgE<gt>
+
+=head1 SUPPORT
+
+For support details, please look at C<perldoc CPANDB> and use the
+corresponding support methods.
+
+=head1 LICENSE
+
+This has the same copyright and licensing terms as L<CPANDB>.
+
+=cut