Make sure the POD headings are linkable

diff --git a/lib/CPANPLUS/Dist/Gentoo/Atom.pm b/lib/CPANPLUS/Dist/Gentoo/Atom.pm
index 7a3acbb44f26c60017b156b42aaaa44a3a4f2b2f..eef7cff2efc7d04c848985d2c199dc1113e4246f 100644 (file)
--- a/lib/CPANPLUS/Dist/Gentoo/Atom.pm
+++ b/lib/CPANPLUS/Dist/Gentoo/Atom.pm
@@ -39,7 +39,24 @@ my $version_rx  = $CPANPLUS::Dist::Gentoo::Version::version_rx;
 
 =head1 METHODS
 
-=head2 C<< new category => $category, name => $name [, version => $version, range => $range, ebuild => $ebuild ] >>
+=head2 C<new>
+
+    # Infer everything from $atom :
+    my $cdga = CPANPLUS::Dist::Gentoo::Atom->new(
+     atom     => $atom,
+     # Optional :
+     ebuild   => $ebuild,
+    );
+
+    # Or specify the attributes manually :
+    my $cdga = CPANPLUS::Dist::Gentoo::Atom->new(
+     category => $category,
+     name     => $name,
+     version  => $version,
+     range    => $range,
+     # Optional :
+     ebuild   => $ebuild,
+    );
 
 Creates a new L<CPANPLUS::Dist::Gentoo::Atom> object from the supplied C<$category>, C<$name>, C<$version>, C<$range> and C<$ebuild>.
 
@@ -93,7 +110,9 @@ sub new {
  }, $class;
 }
 
-=head2 C<new_from_ebuild $ebuild>
+=head2 C<new_from_ebuild>
+
+    my $cdga = CPANPLUS::Dist::Gentoo::Atom->new_from_ebuild($ebuild);
 
 Creates a new L<CPANPLUS::Dist::Gentoo::Atom> object by inferring the category, name and version from the given C<$ebuild>
 
@@ -228,7 +247,9 @@ my %order = (
  '>'  =>  2,
 );
 
-=head2 C<and @atoms>
+=head2 C<and>
+
+    my $cdga = CPANPLUS::Dist::Gentoo::Atom->and(@atoms);
 
 Compute the ranged atom representing the logical AND between C<@atoms> with the same category and name.
 
@@ -278,7 +299,9 @@ sub and {
  }
 }
 
-=head2 C<fold @atoms>
+=head2 C<fold>
+
+    my @folded = CPANPLUS::Dist::Gentoo::Atom->fold(@atoms);
 
 Returns a list built from C<@atoms> but where there's only one atom for a given category and name.
 

diff --git a/lib/CPANPLUS/Dist/Gentoo/Guard.pm b/lib/CPANPLUS/Dist/Gentoo/Guard.pm
index 6ba511d2d37f66514f234d202640a2673f7b9942..59567cdbf2ec4c5e4c5fb87becaaa37a6283b939 100644 (file)
--- a/lib/CPANPLUS/Dist/Gentoo/Guard.pm
+++ b/lib/CPANPLUS/Dist/Gentoo/Guard.pm
@@ -21,7 +21,9 @@ This is a scope guard object helper for L<CPANPLUS::Dist::Gentoo>.
 
 =head1 METHODS
 
-=head2 C<new $coderef>
+=head2 C<new>
+
+    my $guard = CPANPLUS::Dist::Gentoo::Guard->new($coderef);
 
 Creates a new L<CPANPLUS::Dist::Gentoo::Guard> object that will call C<$coderef> when destroyed.
 

diff --git a/lib/CPANPLUS/Dist/Gentoo/Maps.pm b/lib/CPANPLUS/Dist/Gentoo/Maps.pm
index 84ede042cb457ff12c42ed3572e594c42020b7d8..7ba1e945ad1cbbd2005bb69c0eed7687750b79e5 100644 (file)
--- a/lib/CPANPLUS/Dist/Gentoo/Maps.pm
+++ b/lib/CPANPLUS/Dist/Gentoo/Maps.pm
@@ -32,7 +32,9 @@ close DATA;
 
 =head1 FUNCTIONS
 
-=head2 C<name_c2g $name>
+=head2 C<name_c2g>
+
+    my $gentoo_pkg = name_c2g($cpan_dist);
 
 Maps a CPAN distribution name to the corresponding Gentoo package name.
 
@@ -43,7 +45,9 @@ sub name_c2g {
  return $name_mismatch{$name} || $name;
 }
 
-=head2 C<license_c2g @licenses>
+=head2 C<license_c2g>
+
+    my @gentoo_licenses = license_c2g(@meta_licenses);
 
 Maps F<META.yml> C<license> tag values to the corresponding list of Gentoo license identifiers.
 Duplicates are stripped off.
@@ -77,7 +81,9 @@ sub license_c2g {
     @_;
 }
 
-=head2 C<version_c2g $name, $version>
+=head2 C<version_c2g>
+
+    my $gentoo_version = version_c2g($cpan_dist, $cpan_version);
 
 Converts the C<$version> of a CPAN distribution C<$name> to a Gentoo version number.
 
@@ -287,7 +293,9 @@ sub version_c2g {
  return $handler->($v);
 }
 
-=head2 C<perl_version_c2g $version>
+=head2 C<perl_version_c2g>
+
+    my $gentoo_version = perl_version_c2g($perl_version);
 
 Converts a perl version number as you can find it in CPAN prerequisites to a Gentoo version number.
 
@@ -312,7 +320,9 @@ sub perl_version_c2g {
  return join '.', map int, @parts;
 }
 
-=head2 C<get_portage_timestamp $portage>
+=head2 C<get_portage_timestamp>
+
+    my $timestamp = get_portage_timestamp($portage);
 
 Get the numerical timestamp associated with the portage tree located at C<$portage>.
 Requires L<POSIX::strptime>, and returns C<undef> if it is not available.

diff --git a/lib/CPANPLUS/Dist/Gentoo/Version.pm b/lib/CPANPLUS/Dist/Gentoo/Version.pm
index cb2b98b92758967998c20e77c2bdb6c64fb3fb1e..cc21274bdab6f9a8339e45257745bf470e9de952 100644 (file)
--- a/lib/CPANPLUS/Dist/Gentoo/Version.pm
+++ b/lib/CPANPLUS/Dist/Gentoo/Version.pm
@@ -50,7 +50,9 @@ my $capturing_version_rx = qr{
 
 =head1 METHODS
 
-=head2 C<new $vstring>
+=head2 C<new>
+
+    my $cdgv = CPANPLUS::Dist::Gentoo::Version->new($vstring);
 
 Creates a new L<CPANPLUS::Dist::Gentoo::Version> object from the version string C<$vstring>.