#!perl

use 5.010;
use strict;
use warnings;

use App::PMUtils;
use Perinci::CmdLine::Any -prefer_lite=>1;

our $DATE = '2014-08-16'; # DATE
our $VERSION = '0.20'; # VERSION

our %SPEC;
$SPEC{pmdoc} = {
    v => 1.1,
    summary => 'Show documentation of Perl module',
    description => <<'_',

This function executes `perldoc`. Basically what it offers is command-line
completion.

_
    args => {
        module => {
            schema => 'str*',
            req => 1,
            pos => 0,
            completion => $App::PMUtils::_complete_module,
        },
    },
    deps => {
        prog => 'perldoc',
    },
};
sub pmdoc {
    my %args = @_;
    my $mod = $args{module};
    $mod =~ s!/!::!g;
    my @cmd = ("perldoc", $mod);
    exec @cmd;
    # [200]; # unreachable
}

Perinci::CmdLine::Any->new(
    url => '/main/pmdoc',
)->run;

# ABSTRACT: Show documentation of Perl module
# PODNAME: pmdoc

__END__

=pod

=encoding UTF-8

=head1 NAME

pmdoc - Show documentation of Perl module

=head1 VERSION

This document describes version 0.20 of pmdoc (from Perl distribution App-PMUtils), released on 2014-08-16.

=head1 SYNOPSIS

Basic usage:

 % pmdoc Some::Module

To active bash completion:

 % complete -C pmdoc pmdoc ; # can be put in bash startup file e.g. .bashrc
 % pmdoc Some<tab>
 % pmdoc test/builder/mo<tab> ; # resolve to Test/Builder/Module, can resolve case
 % pmdoc "Text::Abb<tab>      ; # use quote (' or ") if you want to use :: as separator

=head1 HOMEPAGE

Please visit the project's homepage at L<https://metacpan.org/release/App-PMUtils>.

=head1 SOURCE

Source repository is at L<https://github.com/sharyanto/perl-App-PMUtils>.

=head1 BUGS

Please report any bugs or feature requests on the bugtracker website L<https://rt.cpan.org/Public/Dist/Display.html?Name=App-PMUtils>

When submitting a bug or request, please include a test-file or a
patch to an existing test-file that illustrates the bug or desired
feature.

=head1 AUTHOR

Steven Haryanto <stevenharyanto@gmail.com>

=head1 COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by Steven Haryanto.

This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.

=cut
