| From: | "Matthew O. Persico" <persicom [...] acedsl.com> |
| To: | <spoon [...] cpan.org> |
| Date: | Tue, 2 Dec 2003 20:40:24 -0500 |
| Subject: | PHP::Strings |
I got sucked in. I started scrolling down, reading over and over "THIS FUNCTION WILL NOT BE IMPLEMENTED" and I kept saying to myself, "What kind of sick joke is this?" Then I got to FOR THOSE WHO HAVE READ THIS FAR and I laughed my butt off.
Seriously, I think this is a great module. What you SHOULD do is implement each function that you say will not be implemented as a print of the docs to stderr and a die. Like this:
sub str_replace {
die <<EODEATH
=item str_replace
PHP::Strings::str_replace IS NOT IMPLEMENTED.
See the s/// operator. perlop and perlre have details.
EODEATH
=cut
}
If you think I'm nuts, try this little experiment:
1) Create the file foo.pl:
=head1 NAME foo
=cut
sub selfdocfunc {
die <<EOPOD
=item selfdocfunc
the docs for selfdocfunc
=cut
EOPOD
}
print 'I better get here';
selfdocfunc;
print 'I better not get here'
__END__
2) call it:
perl foo.pl
3) pod it
perldoc -t -F foo.pl
It works!
--
Matthew