Practice of Programming

プログラム とか Linuxとかの話題

select some sections from Module's POD

Pod::Section
Usage:

% podsection Catalyst SYNOPSIS    # as text
% podsection -u Catalyst SYNOPSIS # as plain pod
% podsection Catalyst req # show pod of req method

Examle:

%podsection Catalyst req res
  $c->req
    Returns the current Catalyst::Request object, giving access to
    information about the current client request (including parameters,
    cookies, HTTP headers, etc.). See Catalyst::Request.

  $c->res
    Returns the current Catalyst::Response object, see there for details.

I create this module to abstract the part of Module's function/method explanation.
So, the sections like SYNOSIS, DESCRIPTION etc. are not assumed, but it works well in most case.


If you use this module in program,

use Pod::Section qw/select_podsection/;
my $pod = select_podsection("Catalyst", "req");

To parse POD, This module uses Pod::Abstract.