NAME

PerlIO::via::Pod - PerlIO layer for extracting plain old documentation

SYNOPSIS

use PerlIO::via::Pod;

open( my $in, '<:via(Pod)', 'file.pm' )
 or die "Can't open file.pm for reading: $!\n";

open( my $out, '>:via(Pod)', 'file.pm' )
 or die "Can't open file.pm for writing: $!\n";

VERSION

This documentation describes version 0.07.

DESCRIPTION

This module implements a PerlIO layer that extracts plain old documentation (pod) on input and on output. It is intended as a development tool only, but may have uses outside of development.

REQUIRED MODULES

(none)

EXAMPLES

Here are some examples, some may even be useful.

Pod only filter

A script that only lets plain old documentation pass.

#!/usr/bin/perl
use PerlIO::via::Pod;
binmode( STDIN,':via(Pod)' ); # could also be STDOUT
print while <STDIN>;

METHODS

PUSHED

Instantiate a new PerlIO::via::Pod object.

FILL

Parse the file extracting POD.

WRITE

Write the file containing only POD.

SEE ALSO

PerlIO::via, PerlIO::via::UnPod and any other PerlIO::via modules on CPAN.

COPYRIGHT

maintained by LNATION, <thisusedtobeanemail@gmail.com>

Copyright (c) 2002, 2003, 2004, 2012 Elizabeth Mattijsen. All rights reserved. This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.