Make sure the POD headings are linkable

diff --git a/lib/App/Rgit.pm b/lib/App/Rgit.pm
index 6b43f16a071e63439d25a8bfc58245e055fe99b2..f0bbdde0919e67912cfebde85e65f2706efecbdf 100644 (file)
--- a/lib/App/Rgit.pm
+++ b/lib/App/Rgit.pm
@@ -26,7 +26,14 @@ This is an internal class to L<rgit>.
 
 =head1 METHODS
 
-=head2 C<< new root => $root, git => $git, cmd => $cmd, args => \@args >>
+=head2 C<new>
+
+    my $ar = App::Rgit->new(
+     root => $root,
+     git  => $git,
+     cmd  => $cmd,
+     args => \@args,
+    );
 
 Creates a new L<App::Rgit> object that's bound to execute the command C<$cmd> on all the C<git> repositories inside C<$root> with C<@args> as arguments and C<$git> as C<git> executable.
 

diff --git a/lib/App/Rgit/Command.pm b/lib/App/Rgit/Command.pm
index 5edd9c284d15915bbb8ec8f5c960d02de7305016..b4d78dd4984270f922a9b080b3c6963455651a40 100644 (file)
--- a/lib/App/Rgit/Command.pm
+++ b/lib/App/Rgit/Command.pm
@@ -27,7 +27,12 @@ This is an internal class to L<rgit>.
 
 =head1 METHODS
 
-=head2 C<< new cmd => $cmd, args => \@args >>
+=head2 C<new>
+
+    my $arc = App::Rgit::Command->new(
+     cmd  => $cmd,
+     args => \@args,
+    );
 
 Creates a new command object for C<$cmd> that is bound to be called with arguments C<@args>.
 
@@ -63,7 +68,10 @@ sub new {
  }, $class;
 }
 
-=head2 C<< action $cmd [ => $pkg ] >>
+=head2 C<action>
+
+    my $pkg = $arc->action($cmd);
+    $arc->action($cmd => $pkg);
 
 If C<$pkg> is supplied, handles command C<$cmd> with C<$pkg> objects.
 Otherwise, returns the current class for C<$cmd>.
@@ -84,7 +92,9 @@ sub action {
  $commands{$cmd} = $pkg;
 }
 
-=head2 C<report $conf, $repo, $status>
+=head2 C<report>
+
+    my $code = $arc->report($conf, $repo, $status);
 
 Reports that the execution of the command in C<$repo> exited with C<$status> to the current command's policy.
 Returns what policy C<report> method returned, which should be one of the policy codes listed in C<App::Rgit::Utils>.
@@ -113,7 +123,9 @@ BEGIN {
  eval "sub $_ { \$_[0]->{$_} }" for qw/cmd args policy/;
 }
 
-=head2 C<run $conf>
+=head2 C<run>
+
+    my $code = $arc->run($conf);
 
 Runs the command with a L<App::Rgit::Config> configuration object.
 Handles back the code to return to the system and the last policy.

diff --git a/lib/App/Rgit/Config.pm b/lib/App/Rgit/Config.pm
index 29ebd7bd42b81445dda9ff07fea62e8861990cdc..c384203a69d0cdac90ca12626ed0f3c4688b9b78 100644 (file)
--- a/lib/App/Rgit/Config.pm
+++ b/lib/App/Rgit/Config.pm
@@ -32,7 +32,12 @@ This is an internal class to L<rgit>.
 
 =head1 METHODS
 
-=head2 C<< new root => $root, git => $git >>
+=head2 C<new>
+
+    my $arc = App::Rgit::Config->new(
+     root => $root,
+     git  => $git,
+    );
 
 Creates a new configuration object based on the root directory C<$root> and using C<$git> as F<git> executable.
 
@@ -90,13 +95,21 @@ sub new {
  }, $conf;
 }
 
-=head2 C<info $msg>
+=head2 C<info>
+
+    $arr->info($msg);
+
+=head2 C<warn>
+
+    $arr->warn($msg);
+
+=head2 C<err>
 
-=head2 C<warn $msg>
+    $arr->err($msg);
 
-=head2 C<err $msg>
+=head2 C<crit>
 
-=head2 C<crit $msg>
+    $arr->crit($msg);
 
 Notifies a message C<$msg> of the corresponding level.
 

diff --git a/lib/App/Rgit/Guard.pm b/lib/App/Rgit/Guard.pm
index 6bcd078fe48accb09a0a2a939699f562db17884c..97408ad829ad148b01bf02a889a5c196d0ece2ab 100644 (file)
--- a/lib/App/Rgit/Guard.pm
+++ b/lib/App/Rgit/Guard.pm
@@ -23,7 +23,9 @@ This is an internal module to L<rgit>.
 
 =head1 METHODS
 
-=head2 C<new $callback>
+=head2 C<new>
+
+    my $guard = App::Rgit::Guard->new($callback);
 
 Creates a new C<App::Rgit::Guard> object that will call C<$callback> when it is destroyed.
 

diff --git a/lib/App/Rgit/Policy.pm b/lib/App/Rgit/Policy.pm
index d48141769f5511f60e920d5b28298f34102b1b0c..1af0cad30cd87999ff9361a3210444e8c808147f 100644 (file)
--- a/lib/App/Rgit/Policy.pm
+++ b/lib/App/Rgit/Policy.pm
@@ -23,7 +23,9 @@ This is an internal class to L<rgit>.
 
 =head1 METHODS
 
-=head2 C<< new policy => $policy >>
+=head2 C<new>
+
+    my $arp = App::Rgit::Policy->new(policy => $policy);
 
 Creates a new policy object of type C<$policy> by requiring and redispatching the method call to the module named C<$policy> if it contains C<'::'> or to C<App::Rgit::Policy::$policy> otherwise.
 The class represented by C<$policy> must inherit this class.
@@ -47,7 +49,9 @@ sub new {
  bless { }, $class;
 }
 
-=head2 C<handle $cmd, $config, $repo, $status, $signal>
+=head2 C<handle>
+
+    my $code = $arp->handle($cmd, $config, $repo, $status, $signal);
 
 Make the policy handle the end of execution of the L<App::Rgit::Command> object C<$cmd> with L<App::Rgit::Config> configuration C<$config> in the L<App::Rgit::Repository> repository C<$repo> that exited with status C<$status> and maybe received signal C<$sigal>.
 

diff --git a/lib/App/Rgit/Repository.pm b/lib/App/Rgit/Repository.pm
index fbf3f8619f0ff5ec7a1dcea3d34eaf07f5fcc1c9..f1dc149a628e2d635260631a82a9ef25a175c526 100644 (file)
--- a/lib/App/Rgit/Repository.pm
+++ b/lib/App/Rgit/Repository.pm
@@ -42,7 +42,12 @@ This is an internal class to L<rgit>.
 
 =head1 METHODS
 
-=head2 C<< new dir => $dir [, fake => 1 ] >>
+=head2 C<new>
+
+    my $arr = App::Rgit::Repository->new(
+     dir  => $dir,
+     fake => $bool,
+    );
 
 Creates a new repository starting from C<$dir>.
 If the C<fake> option is passed, C<$dir> isn't checked to be a valid C<git> repository.
@@ -116,7 +121,9 @@ sub chdir {
  return 1;
 }
 
-=head2 C<run $conf, @args>
+=head2 C<run>
+
+    my $code = $arr->run($conf, @args);
 
 Runs C<git @args> on the repository for the L<App::Rgit::Config> configuration C<$conf>.
 When the repository isn't fake, the format substitutions applies to C<@args> elements.

diff --git a/lib/App/Rgit/Utils.pm b/lib/App/Rgit/Utils.pm
index c081d9b99cb5ed4453abbaac78eea9b3241a7330..ee1fdd348014622aec683bd379cd034a4838c1f5 100644 (file)
--- a/lib/App/Rgit/Utils.pm
+++ b/lib/App/Rgit/Utils.pm
@@ -26,7 +26,9 @@ This is an internal module to L<rgit>.
 
 =head1 FUNCTIONS
 
-=head2 C<abs_path $path>
+=head2 C<abs_path>
+
+    my $absolute_path = abs_path($path);
 
 Forcefully make a path C<$path> absolute (in L<Cwd/abs_path>'s meaning of the term) when it isn't already absolute or when it contains C<'..'>.
 
@@ -49,7 +51,13 @@ sub abs_path {
 
 =head1 CONSTANTS
 
-=head2 C<NEXT>, C<REDO>, C<LAST>, C<SAVE>
+=head2 C<NEXT>
+
+=head2 C<REDO>
+
+=head2 C<LAST>
+
+=head2 C<SAVE>
 
 Codes to return from the C<report> callback to respectively proceed to the next repository, retry the current one, end it all, and save the return code.
 
@@ -62,7 +70,15 @@ use constant {
  LAST => 0x8,
 };
 
-=head2 C<DIAG>, C<INFO>, C<WARN>, C<ERR> and C<CRIT>
+=head2 C<DIAG>
+
+=head2 C<INFO>
+
+=head2 C<WARN>
+
+=head2 C<ERR>
+
+=head2 C<CRIT>
 
 Message levels.