#!/usr/bin/env perl
# podpath - print the path to the Pod

# ------ pragmas
use strict;
use warnings;
use pmtools;

our $VERSION = '2.2.0';

for my $module (@ARGV) {
    if ( $module =~ /^perl/ ) {
	     system("$^X -S stdpods | grep $module");
    } else {
	    $module =~ s#::#/#gmsx;
        my $found = 0;
        my $pod_iter = pmtools::new_pod_iterator($module);
        while (my $pod_file = $pod_iter->()) {
            next if !-s $pod_file;

            # in case we find the .pm before the .pod
            my $output = `grep '=head1' $pod_file`;
            if ($? == 0) {
                print "$pod_file\n";

        if (!$found) {
            print STDERR "$0: Can't locate $module.pm or $module.pod "
            . "in \@INC (\@INC contains: " . join(' ', @INC) . ")\n";


=head1 NAME

podpath - print the path to the Pod


podpath prints the path to the Pod. podpath calls stdpods underneath
if the Pod name includes 'perl'. Otherwise, it searches down
@INC, printing the '.pod' filename if there is a separate Pod
file, otherwise printing the 'pm' filename. This accommodates
systems where the Pod lives in a separate file from the module file.


    $ podpath Cwd

It works with alternate installations, too:

    $ devperl -S podpath perlfunc

    $ oldperl -S podpath IO::Handle

    $ filsperl -S podpath Thread

=head1 SEE ALSO



Copyright (C) 1999 Tom Christiansen.

Copyright (C) 2006-2014, 2018 Mark Leighton Fisher.

=head1 LICENSE

This is free software; you can redistribute it and/or modify it
under the terms of either:
(a) the GNU General Public License as published by the Free
Software Foundation; either version 1, or (at your option) any
later version, or
(b) the Perl "Artistic License".
(This is the Perl 5 licensing scheme.)

Please note this is a change from the
original pmtools-1.00 (still available on CPAN),
as pmtools-1.00 were licensed only under the
Perl "Artistic License".