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

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";

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>;

SEE ALSO

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

COPYRIGHT

Copyright (c) 2002-2003 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.

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